How to add Railway MCP Server to Windsurf

Community server to manage Railway.app projects, services, and deployments via your agent. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

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

Windsurf 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 Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Railway MCP Server config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Railway MCP Server's tools become available to Cascade.

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 Windsurf

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 + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Railway MCP Server config there under the "mcpServers" key and restart the client.

Is Railway MCP Server safe to use with Windsurf?

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