PlugWiki

Railway MCP Server

Official · by RailwayRemote
Gethttps://mcp.railway.comrailwayapp/monoDocs

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.

Install Railway MCP

Claude Code

  1. 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. 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-projects

  • Lists 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-services

  • Creates 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-project

  • Redeploys 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 · redeploy

  • Applies 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-deploy

  • Hands 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-agent

  • Lists 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-flags

  • Shows 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-flag

  • Turns 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-flag

  • Deletes 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-flag

  • Used 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-onlyNo read-only mode is documented. Destructive tools carry protocol-level hints so clients ask for confirmation.
Talks tomcp.railway.com. backboard.railway.com (local mode, Railway API)
Sign-in and keysOAuth tokens held by your MCP client (short-lived, revocable in Railway account settings), or the Railway CLI's login session
Scopes
  • OAuth: the workspaces and projects you pick at sign-in

  • CLI connection: your railway login session

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.

ServerOfficialRunsSign-inCan change thingsMaintained
Railway MCPThis pageOfficialHostedRailway accountYesActive
railway-mcp-serverOfficialLocal–YesArchived
jason-tan-swe/railway-mcpCommunityLocalAPI 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.

    Source
  • Deploy a database

    Deploy a Postgres database

    Source
  • Pull environment variables

    Pull environment variables for my project and save them to a .env file

    Source
  • Debug a failing deployment

    Use the railway agent to figure out why my backend service is crashing on deploy

    Source
  • Redeploy a service

    Redeploy my api service in the production environment

    Source
  • Flip 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

DocsGitHubOfficial MCP Registryrailway mcp (CLI)

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 3
  1. Railway MCP Server · docs.railway.com
  2. railway mcp · docs.railway.com
  3. @railway/mcp-server · npmjs.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.