Railway MCP Server
Lets Claude Code, Cursor or Codex create, deploy and redeploy your Railway projects. Railway runs it for you, and you sign in with your Railway account.
This is Railway's official way to let your AI assistant work in your Railway account, and Railway hosts it. You can ask it to create projects, deploy templates, pull environment variables, redeploy services, change feature flags, or hand a harder job like debugging a failed deploy to Railway's own agent. It can change live services and there is no read-only mode, so approve each redeploy yourself. If your network blocks Railway's server, the Railway CLI can also run a local version with more tools.
Good for
- Developers who deploy to Railway and want their coding assistant to ship and redeploy for them
- People debugging a crashing deploy who want Railway's own agent to read the logs
- Teams that manage feature flags in Railway
- Anyone who wants Railway access without pasting an API token into a config file
Works in
8 supported · 6 should work
Tap an app to see how to set it up and any known problems.
Railway's docs cover it: run railway mcp install, or add the URL with claude mcp add and sign in on first use. docs.railway.com
Railway's docs cover it: use the Add to Cursor button or railway mcp install. docs.railway.com
Railway's docs cover it: add an entry to .vscode/mcp.json using the CLI or the direct URL. docs.railway.com
Railway's docs cover it with browser sign-in only: add the URL to Windsurf's MCP config and reload. docs.railway.com
Railway's docs cover it: railway mcp install, or add the URL to your Codex config. docs.railway.com
Railway's docs cover it: railway mcp install writes ~/.copilot/mcp-config.json for you. docs.railway.com
Railway's docs cover it with browser sign-in only: add the URL under MCP Servers, then Configure. docs.railway.com
Railway's docs cover it: railway mcp install writes opencode.json for you. docs.railway.com
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Install Railway MCP
Claude Code
- 1
Copy this prompt.
Add the Railway MCP server to Claude Code. Run this command: claude mcp add railway --transport http https://mcp.railway.com Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Railway account.
Read-only mode: There is no read-only mode. Keep your app's setting that asks before each action turned on, and pick only the projects it needs when you sign in.
The first time it runs a tool, a browser window asks you to sign in to Railway and choose which workspaces and projects it can reach. Already use the Railway CLI? The CLI option reuses your railway login instead, and railway mcp install --local sets up a local mode with more tools for networks that block Railway's server.
From the vendor's docs. Source.
Tools
Lists the Railway projects you can access
Shows the projects in the workspaces you connected, so you or the assistant can pick one to work on.
Try: “Which Railway projects do I have?”
Network ·
list-projectsLists the services inside a project
Shows the services, such as your web app, worker or database, that run inside a Railway project.
Try: “What services are running in my shop-backend project?”
Network ·
list-servicesCreates a new Railway project
Creates an empty Railway project you can then deploy code or templates into.
Try: “Create a new Railway project called landing-page.”
Write ·
create-projectRedeploys a service so it restarts with its current setup
Starts a fresh deployment of a service, for example after you change its variables. Railway counts this as an action to review before approving.
Try: “Redeploy my api service in the production environment.”
Write ·
redeployApplies staged changes and deploys them
Commits the changes waiting in a project and deploys them. It is marked destructive, so your app should ask you before it runs.
Try: “Apply the staged changes in my project and deploy them.”
Write ·
accept-deployHands a multi-step job, like debugging a failed deploy, to Railway's agent
Passes a plain-language request to Railway's own AI agent, which can do several steps such as reading logs, finding why a deploy crashed and changing service settings.
Try: “Use the railway agent to figure out why my backend service is crashing on deploy.”
Write ·
railway-agentLists the feature flags in a project
Shows the feature flags set up in a Railway project.
Try: “List feature flags for my storefront project.”
Network ·
list-feature-flagsShows the current value of one feature flag
Reads one feature flag and tells you whether it is on and how it is set.
Try: “Is the checkout-v2 flag turned on?”
Network ·
get-feature-flagTurns a feature flag on or off, or changes its value
Creates or updates a feature flag in a project. Railway says this needs admin access.
Try: “Set the checkout-v2 feature flag to true on my storefront project.”
Write ·
set-feature-flagDeletes a feature flag
Removes a feature flag from a project. It needs admin access and is marked destructive, so your app should ask first.
Try: “Delete the old-banner feature flag.”
Delete ·
delete-feature-flagUsed by the assistant behind the scenes
Checks which Railway account you are signed in as
Returns the Railway account the connection uses, which helps the assistant confirm it is signed in.
Try: “Which Railway account am I connected with?”
Network ·
whoami
From the official docs
Pros and cons
Good
- Built and hosted by Railway, with nothing to run for the browser sign-in option
- One CLI command writes the config for Claude Code, Cursor, Codex, Copilot CLI and OpenCode
- Sign-in lets you pick which workspaces and projects it can reach
- Can hand multi-step jobs like log analysis to Railway's own agent
- Destructive tools are flagged so your app asks before running them
- A local mode works on networks that block Railway's server
Watch out
- No read-only mode
- It can redeploy and change live services
- The hosted version has fewer tools than the CLI's local mode
- Project tokens are not accepted, so unattended setups need a user sign-in
- Windsurf and Cline can only connect with browser sign-in, not the CLI
Permissions
high risk · 4 things to watch
High risk
A wrong instruction could redeploy or change a live service, or delete feature flags, in the projects you connect. When you sign in, pick only the projects it needs and approve every redeploy and delete yourself.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can redeploy and change live services
It can redeploy services, commit staged changes, and pass open-ended jobs to Railway's agent. Approve each of these yourself and keep it away from production where you can. docs.railway.com
It can delete feature flags
Deletes are marked destructive so your app should ask first. Keep that confirmation turned on. docs.railway.com
Local mode can remove services and volumes
The CLI's local mode adds tools that remove services, domains, volumes and buckets. It shows a preview first, so read it before you confirm. docs.railway.com
You choose which projects it can reach
With browser sign-in you pick the workspaces and projects, and you can revoke access in your Railway account settings. docs.railway.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only mode is documented. Destructive tools carry protocol-level hints so clients ask for confirmation. |
|---|---|
| Talks to | mcp.railway.com. backboard.railway.com (local mode, Railway API) |
| Sign-in and keys | OAuth tokens held by your MCP client (short-lived, revocable in Railway account settings), or the Railway CLI's login session |
| Scopes |
|
Alternatives
Use Railway's hosted server: the old local server is archived and its features now ship inside the Railway CLI. Community servers only make sense if you need an API-token setup Railway does not offer.
| Server | Official | Runs | Sign-in | Can change things | Maintained |
|---|---|---|---|---|---|
| Railway MCPThis page | Official | Hosted | Railway account | Yes | Active |
| railway-mcp-server | Official | Local | – | Yes | Archived |
| jason-tan-swe/railway-mcp | Community | Local | API token | – | Jun 2025 commit |
Questions
What is the Railway MCP server URL?
https://mcp.railway.com. Apps with browser sign-in connect to it directly. The railway mcp CLI command also connects there using your Railway login.
Is the Railway MCP server free?
Railway lists no separate charge for it. You need a Railway account, and anything it creates or deploys is billed as normal Railway usage.
Do I need the Railway CLI?
No. The CLI is the default way to connect, but apps that support browser sign-in can use the URL without it. The CLI does make setup one command.
Is it safe to let my assistant use Railway?
It can redeploy and change live services, so treat it like giving someone deploy access. Pick only the projects it needs when you sign in and approve each redeploy or delete.
Can it delete my services or databases?
Not directly on the hosted server, where the only delete tool removes feature flags. Its Railway agent tool can make multi-step changes, so read what it plans before you approve. The CLI's local mode adds tools that remove services, domains, volumes and buckets, each after a preview and your confirmation.
Can I use a Railway project token?
No. It needs a signed-in user so Railway can track billing and who did what.
What happened to @railway/mcp-server?
It is deprecated. The npm package now only starts the MCP server built into the Railway CLI, and its GitHub repo is archived.
What if my network blocks mcp.railway.com?
Use the CLI's local mode, which talks to the Railway API from your computer. It has a different and larger set of tools.
How do I add Railway to Claude Code?
Use the Claude Code tab in the install box above. The first time it runs a tool, it asks you to sign in to Railway.
Examples
Create and deploy a new app
Create a Next.js app in this directory and deploy it to Railway. Also assign it a domain.
SourceDeploy a database
Deploy a Postgres database
SourcePull environment variables
Pull environment variables for my project and save them to a .env file
SourceDebug a failing deployment
Use the railway agent to figure out why my backend service is crashing on deploy
SourceRedeploy a service
Redeploy my api service in the production environment
SourceFlip a feature flag
Set the checkout-v2 feature flag to true on project <projectId>
Source
Information
updated Nov 2, 2026
- Publisher
- Railway (official)
- Endpoint
https://mcp.railway.com- Transport
- Streamable HTTP
- Auth
- OAuth
- Version
- 1.0.0
- Listed in
- Official MCP registry
Other Railway MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 3Hide
- Railway MCP Server · docs.railway.com
- railway mcp · docs.railway.com
- @railway/mcp-server · npmjs.com