railway-mcp
Provides tools to manage Railway projects, services, deployments, variables, environments, and domains.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@railway-mcplist my Railway projects"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
railway-mcp
An MCP server that exposes the Railway API as tools for Claude. Manage your Railway projects, services, deployments, variables, environments, and domains directly from Claude.
Tools
Tool | Description |
| Get current authenticated user details |
| List all Railway projects |
| Get project details with services and environments |
| Create a new Railway project |
| Update project name or description |
| Permanently delete a project |
| List all environments in a project |
| Get environment details |
| Create a new environment (optionally clone from existing) |
| Rename an environment |
| Delete an environment and all its deployments |
| Get service details |
| Get environment-specific service config |
| Create a service from GitHub, Docker image, or empty |
| Update service name or icon |
| Permanently delete a service |
| Trigger a new deployment |
| List deployments for a service |
| Get deployment details |
| Redeploy an existing deployment |
| Restart a deployment without rebuilding |
| Roll back to a previous deployment |
| Stop a running deployment |
| Cancel a building/queued deployment |
| Fetch build logs for a deployment |
| Fetch runtime logs for a deployment |
| Get environment variables for a service |
| Set or update a single variable |
| Set or update multiple variables at once |
| Delete a variable |
| List all domains for a service |
| Generate a Railway-provided domain |
| Delete a Railway-provided domain |
| Add a custom domain |
| Remove a custom domain |
Related MCP server: Railway MCP Server
Environment Variables
Variable | Required | Description |
| Yes | Railway API token — generate at https://railway.com/account/tokens |
| No |
|
| No | Port to listen on (default |
Deploy to Railway
Fork or push this repo to GitHub
Go to Railway → New Project → Deploy from GitHub repo
Select this repository
In Variables, add
RAILWAY_TOKENwith your Railway API tokenRailway will build and deploy automatically
Go to Settings → Networking → Generate Domain to get your public URL
Connect to Claude
Remote (Railway deployment)
Add to claude.ai MCP settings:
{
"mcpServers": {
"railway": {
"url": "https://your-app.up.railway.app/sse"
}
}
}Local (Claude Desktop / stdio)
{
"mcpServers": {
"railway": {
"command": "node",
"args": ["/path/to/railway-mcp/dist/index.js"],
"env": {
"TRANSPORT": "stdio",
"RAILWAY_TOKEN": "your_railway_token"
}
}
}
}Local Development
cp .env.example .env
# Edit .env with your RAILWAY_TOKEN
npm install
npm run build
node dist/index.jsThis server cannot be deployed
Maintenance
Related MCP Connectors
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceAn MCP server that allows using natural language to manage Cloudflare resources (Workers, KV, R2, D1) through Claude Desktop, VSCode, and other MCP clients.6 npm10Apache 2.0
- AlicenseAqualityDmaintenanceEnables management of Railway.app infrastructure through natural language, allowing users to deploy services, manage environment variables, monitor deployments, and configure projects directly from MCP clients like Claude.38126 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables comprehensive management of Railway infrastructure, including projects, services, variables, and deployments, directly through the Railway GraphQL API. It is designed to work as a remote service over HTTP, allowing seamless integration with cloud-based MCP clients like claude.ai.MIT
- AlicenseNot gradedqualityCmaintenanceUnofficial MCP server for Railway that enables managing Railway infrastructure through natural language, including projects, services, deployments, environments, variables, templates, domains, volumes, observability, integrations, networking, and workflows.54 npm2MIT