railway-mcp

Overview

The railway-mcp server provides comprehensive integration with the Railway.app deployment platform, allowing users to manage projects, services, deployments, and variables through Model Context Protocol. It features authentication via Railway API tokens, supports multiple MCP clients like Claude Desktop and Cursor, and offers both quick installation through Smithery and manual configuration options. The server includes detailed documentation with security considerations, troubleshooting guidance, and example workflows for common use cases.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• configure

  Set your Railway API token

  Try:Configure the Railway API with my tokenTry:Set my Railway API token
• project-list

  List all projects in your account

  Try:List all my Railway projectsTry:Show me my projects on Railway
• project-info

  Get detailed information about a specific project

  Try:Get details about project 12345Try:Show me information about my project
• service-list

  List all services in a specific project

  Try:List all services in my projectTry:Show me the services in project 12345
• service-create-from-repo

  Create a new service from a GitHub repository

  Try:Create a service from my GitHub repoTry:Deploy my GitHub repository as a service
• deployment-list

  List recent deployments for a service

  Try:Show me recent deployments for my serviceTry:List all deployments for service 123
• deployment-trigger

  Trigger a new deployment for a service

  Try:Trigger a new deployment for my serviceTry:Deploy my latest changes
• variable-list

  List variables for a service or environment

  Try:Show me the environment variables for my serviceTry:List all variables in my project
• variable-set

  Create or update a variable

  Try:Set an environment variable named API_KEY with value secret123Try:Create a new variable for my service
• variable-delete

  Delete a variable

  Try:Delete the variable named OLD_CONFIGTry:Remove the API_KEY variable from my service
• service-restart

  Restart a service in a specific environment

  Try:Restart my serviceTry:Restart the web service in production
• database-deploy

  Deploy a new database service

  Try:Deploy a PostgreSQL databaseTry:Create a new database service

Comparable tools

Installation

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

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

FAQ

Is this server officially supported by Railway.app?

No, this is an unofficial community-built MCP server for Railway.app.

Which MCP clients are supported?

Claude Desktop is battle-tested, Cursor needs testing, while Cline and Windsurf are still being evaluated.

How secure is my Railway API token?

Your token is stored in configuration files or environment variables. Sensitive data is masked when displayed, and all API calls use HTTPS.

Compare railway-mcp with