The Railway MCP Server is an experimental local server that provides opinionated workflows and tools for efficiently managing Railway resources. Key capabilities include:
CLI Integration: Verify Railway CLI installation and user login status
Project Management: Create, list, and link projects to your current directory
Service Management: List, link, and deploy services from your directory or Railway Template Library using fuzzy search
Environment Management: Create, link, and manage environments with options to duplicate existing environments and configure service variables
Configuration & Variables: List, set, and manage environment variables, plus generate
railway.app
domains for projects or servicesMonitoring & Logs: Retrieve build or deployment logs with options to specify deployment ID, service, and environment
IDE Integration: Supports setup and usage with Cursor and VSCode
Provides comprehensive tools for managing Railway infrastructure including project and service management, deployments from templates, environment configuration, domain generation, and monitoring through build/deployment logs.
Railway MCP Server
A Model Context Protocol (MCP) server for interacting with your Railway account. This is a local MCP server provides a set of opinionated workflows and tools for managing Railway resources.
The MCP server doesn't include destructive actions by design, that said, you should still keep an eye on which tools and commands are being executed.
Prerequisites
The Railway CLI is required for this server to function.
Installation
Cursor
You can add the Railway MCP Server to Cursor by clicking the button below.
Alternatively, you can add the following configuration to .cursor/mcp.json
VS Code:
Add the following configuration to .vscode/mcp.json
Claude Code:
Example Usage
Creating a new project, deploying it, and generating a domain
Deploy a from a template (database, queue, etc.). Based on your prompt, the appropriate template will be selected and deployed. In case of multiple templates, the agent will pick the most appropriate one. Writing a detailed prompt will lead to a better selection. Check out all of the available templates.
Pulling environment variables
Creating a new environment and setting it as the current linked environment
Available MCP Tools
The Railway MCP Server provides the following tools for managing your Railway infrastructure:
check-railway-status
- Checks that the Railway CLI is installed and that the user is logged inProject Management
list-projects
- List all Railway projectscreate-project-and-link
- Create a new project and link it to the current directory
Service Management
list-services
- List all services in a projectlink-service
- Link a service to the current directorydeploy
- Deploy a servicedeploy-template
- Deploy a template from the Railway Template Library
Environment Management
create-environment
- Create a new environmentlink-environment
- Link an environment to the current directory
Configuration & Variables
list-variables
- List environment variablesset-variables
- Set environment variablesgenerate-domain
- Generate a railway.app domain for a project
Monitoring & Logs
get-logs
- Retrieve build or deployment logs for a service
Development
Prerequisites
Node.js >= 20.0.0
pnpm >= 10.14.0
Clone the repository
git clone https://github.com/railwayapp/railway-mcp-server.git cd railway-mcp-serverInstall dependencies
pnpm installStart the development server
pnpm devThis command will generate a build under
dist/
and automatically rebuild after making changes.Configure your MCP client
Add the following configuration to your MCP client (e.g., Cursor, VSCode) and replace
/path/to/railway-mcp-server/dist/index.js
with the actual path to your built server.Cursor:
.cursor/mcp.json
{ "mcpServers": { "railway-mcp-server": { "command": "node", "args": ["/path/to/railway-mcp-server/dist/index.js"], } } }VSCode:
.vscode/mcp.json
{ "servers": { "railway-mcp-server": { "type": "stdio", "command": "node", "args": ["/path/to/railway-mcp-server/dist/index.js"], } } }
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
Enables interaction with Railway cloud platform through the CLI to manage projects, services, deployments, and environments. Supports creating projects, deploying templates, managing environment variables, and monitoring logs through natural language commands.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityLet Claude and Cursor manage your Railway infrastructure through natural language. Deploy, configure, and monitor - autonomously and safely.Last updated -3819563MIT License
- AsecurityFlicenseAqualityA Model Context Protocol server that provides real-time Caltrain schedule information, allowing AI assistants to look up train departures between any stations and access station information using GTFS data.Last updated -26
- -securityAlicense-qualityEnables interaction with the RunPod REST API through Claude or other MCP-compatible clients, providing tools for managing pods, endpoints, templates, network volumes, and container registry authentications.Last updated -21MIT License
- AsecurityFlicenseAqualityEnables automated access to LoadRunner Cloud APIs for retrieving performance test data, managing projects, and collecting test results. Supports integration with AI clients for building performance engineering workflows and dashboards.Last updated -9