drio
Open app

Railway MCP Server

Source

An unofficial and community-built MCP server for integrating with

Catalog onlyCatalog onlySTDIO

Overview

Railway MCP Server is an unofficial and community-built server designed to integrate with Railway.app, allowing users to manage their Railway infrastructure through natural language commands.

To use the Railway MCP Server, install it via Smithery or manually configure it with your Railway API token in compatible MCP clients like Claude or Cursor. Once set up, you can issue commands to manage projects, services, and deployments.

  • Authentication with Railway API tokens - Project management (list, info, delete) - Deployment management (list, restart) - Service management (create from GitHub repo or Docker image) - Variable management (list, create/update, delete) - Service Network and Volume management
  1. Managing Railway projects and services through natural language.
  2. Automating deployment processes for applications hosted on Railway.app.
  3. Integrating with other MCP clients for streamlined workflows.

Add to your AI client

Use these steps to connect Railway MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "railway-mcp-jason-tan-swe": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-railway-mcp-jason-tan-swe"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "railway-mcp-jason-tan-swe": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-railway-mcp-jason-tan-swe"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "railway-mcp-jason-tan-swe": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-railway-mcp-jason-tan-swe"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "railway-mcp-jason-tan-swe": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-railway-mcp-jason-tan-swe"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "railway-mcp-jason-tan-swe": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-railway-mcp-jason-tan-swe"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "railway-mcp-jason-tan-swe": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-railway-mcp-jason-tan-swe"
      ]
    }
  }
}

FAQ

Is Railway MCP Server free to use?

Yes! It is free to use for everyone.

What are the prerequisites for using Railway MCP Server?

You need Node.js 18+, an active Railway account, and a Railway API token.

Can I use Railway MCP Server with any MCP client?

It is designed to work with specific clients like Claude and Cursor, but may have limited functionality with others.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1670,"uuid":"f968fac1-38a6-4c3a-b6d5-3892705b7d02","name":"railway-mcp","title":"Railway MCP Server","description":"An unofficial and community-built MCP server for integrating with","avatar_url":"https://avatars.githubusercontent.com/u/37030567?v=4","created_at":"2025-03-03T05:39:55.933Z","updated_at":"2025-03-12T10:19:29.893Z","status":"created","author_name":"jason-tan-swe","author_avatar_url":"https://avatars.githubusercontent.com/u/37030567?v=4","tags":"railway,cursor,claude,windsurf,railway-app,model-context-protocol","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/jason-tan-swe/railway-mcp","target":"_self","content":"$29","summary":"$2a","img_url":"https://avatars.githubusercontent.com/u/66716858?s=200&v=4","type":null,"metadata":"{\"star\":\"8\",\"license\":\"MIT license\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-12 18:24:51\"}","user_uuid":"6d5892aa-e48b-4d38-924c-d6aa1748d7e4","tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools