How to add Railway MCP Server to Cursor

Community server to manage Railway.app projects, services, and deployments via your agent. Paste the config into ~/.cursor/mcp.json and restart Cursor.

Last updated June 15, 2026 · 500★ · stdio · apikey

Cursor config for Railway MCP Server

npx -y @jasontanswe/railway-mcp

{
  "mcpServers": {
    "railway-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@jasontanswe/railway-mcp"
      ],
      "env": {
        "RAILWAY_API_TOKEN": "<your-railway-api-token>"
      }
    }
  }
}

Setup steps

1Open Cursor → Settings → MCP → Add new MCP server (or edit ~/.cursor/mcp.json directly).
2Paste the Railway MCP Server config below into the "mcpServers" object.
3Fill in placeholder secrets, then save.
4Cursor reloads MCP servers automatically — check Settings → MCP for a green status dot.
5Ask Cursor to use one of Railway MCP Server's tools to confirm it's connected.

Before you start

Node.js 18+ (required for the built-in fetch API)
An active Railway account
A Railway API token, created at railway.app/account/tokens (an account- or team-scoped token)
An MCP-capable client such as Claude Desktop, Cursor, Cline, or Windsurf

What Railway MCP Server can do in Cursor

configure

Set or update the Railway API token for the session.

project-list

List all projects on your Railway account.

project-info

Get details and environments for a specific project.

project-create

Create a new Railway project.

project-delete

Delete a project.

service-list

List the services within a project.

service-create-from-repo

Deploy a new service from a GitHub repository.

service-create-from-image

Deploy a new service from a Docker image.

Security

The Railway API token grants control over your projects and deployments, so generate a dedicated token and revoke it if exposed. This is an unofficial community project, so review the source before granting production access.

Railway MCP Server + Cursor FAQ

Where is the Cursor config file?

Cursor reads MCP servers from ~/.cursor/mcp.json. Paste the Railway MCP Server config there under the "mcpServers" key and restart the client.

Is Railway MCP Server safe to use with Cursor?

Where do I get the Railway API token?

Create one at railway.app/account/tokens. You can use an account token or a team/project-scoped token; the server reads it from the RAILWAY_API_TOKEN environment variable (or via the configure tool).

Is this an official Railway server?

No. It is a community project (npm package @jasontanswe/railway-mcp) and is not maintained by Railway itself, though it uses Railway's public API.

Which clients does it work with?

It is documented and tested with Claude Desktop and Cursor, with Cline and Windsurf listed as supported but less battle-tested. Any stdio MCP client should work.

View repo Full Railway MCP Server page