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 (Experimental)
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.
Important
This is an experimental project (like really experimental). You should expect bugs and missing features. 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
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 in- Project 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
- Install dependencies
- Start the development serverThis command will generate a build under
dist/
and automatically rebuild after making changes. - Configure your MCP clientAdd 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
VSCode:.vscode/mcp.json
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 -3813858MIT 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 -19MIT 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