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.

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

CLI Version Detection

The MCP server automatically detects your Railway CLI version to use the appropriate features.

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 projects

  • create-project-and-link - Create a new project and link it to the current directory

• Service Management

  • list-services - List all services in a project

  • link-service - Link a service to the current directory

  • deploy - Deploy a service

  • deploy-template - Deploy a template from the Railway Template Library

• Environment Management

  • create-environment - Create a new environment

  • link-environment - Link an environment to the current directory

• Configuration & Variables

  • list-variables - List environment variables

  • set-variables - Set environment variables

  • generate-domain - Generate a railway.app domain for a project

• Monitoring & Logs

  • get-logs - Retrieve build or deployment logs for a service

    • Railway CLI v4.9.0+: Supports lines parameter to limit output and filter parameter for searching logs

    • Older CLI versions: Will stream logs without filtering capabilities

Development

Prerequisites

• Node.js >= 20.0.0

• pnpm >= 10.14.0

1. Clone the repository

   git clone https://github.com/railwayapp/railway-mcp-server.git cd railway-mcp-server

2. Install dependencies

   pnpm install

3. Start the development server

   pnpm dev

   This command will generate a build under dist/ and automatically rebuild after making changes.

4. 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"] } } }

   For Claude Code:

   claude mcp add railway-mcp-server node /path/to/railway-mcp-server/railway-mcp-server/dist/index.js