Railway MCP Server

  

<th align="center">
   Please Note: This is under development and not all features are available yet. 🚧 
</th>

A Model Context Protocol (MCP) server for integrating with the Railway.app platform.

Table of Contents

Features • Installation • Available Tools • Example Workflows • Security • Troubleshooting • Contributing

Features

Status	Meaning
✅	Complete
🚧🔨⏳	Being Built or Needs Testing
❌	Not Built at the moment

• ✅ Authentication with Railway API tokens
• ✅ Project management (list, info, delete)
• ✅ Deployment management (list, restart)
• ✅ Service management (create from GitHub repo or Docker image, list)
• ✅ Variable management (list, create/update, delete)
• ✅ Service Network management
• ✅ Volume management
• ❌ Full support for all templates
  • 🚧🔨⏳ Database template support
  • Automatic database and networking workflows
• 🚧🔨⏳ Most commonly used workflows
• ❌ Automatic GitHub repository linking for services

Installation

Prerequisites

• Node.js 18+ (for built-in fetch API support)
• An active Railway account
• A Railway API token (create one at https://railway.app/account/tokens)

Quick Start

This MCP server is designed to work with MCP Clients like:

• Claude for Desktop | ✅ Battle-Tested
• Cursor | ✅ Needs Testing
• Cline | 🚧🔨⏳ Needs Testing
• Windsurf | 🚧🔨⏳ Needs Testing
• Other MCP Clients | 🚧🔨⏳ Needs Testing

Installing via Smithery

To install railway-mcp automatically, we recommend using Smithery

Claude Desktop

npx -y @smithery/cli install @jason-tan-swe/railway-mcp --client claude

Cursor

npx -y @smithery/cli@latest run @jason-tan-swe/railway-mcp --config "{\"railwayApiToken\":\"token\"}"

Manual Installation For Cursor

1. Head to your cursor settings and find the MCP section

2. Click 'Add new MCP server'

3. Name it however, you like, we recommend railway-mcp for better clarity

4. Paste this command into the 'Command' section, where <RAILWAY_API_TOKEN> is your accounts Railway token:

npx -y @jasontanswe/railway-mcp <RAILWAY_API_TOKEN>

Manual Installation For Claude

1. Create or edit your Claude for Desktop config file:

   • macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the railway-mcp server to your configuration with your API token:

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

When you have multiple MCP servers, your config file might look like this:

{
  "mcpServers": {
    // ... All of your existing MCP servers ...

    // Add the railway-mcp server to your configuration with your API token
    "railway": {
      "command": "npx",
      "args": ["-y", "@jasontanswe/railway-mcp"],
      "env": {
        "RAILWAY_API_TOKEN": "your-railway-api-token-here"
      }
    }
  }
}

3. Restart Claude for Desktop