|Docs

Railway for Agents

Railway exposes a CLI, a hosted MCP server, and an open agent skills format. AI coding agents can use any of them to deploy services, manage environments, and operate Railway on behalf of a user.

Get set up

Install the Railway CLI and configure agent support — skills, MCP, and authentication — in one command. Toggle the options to tailor the command to what you want set up:

curl -fsSL agents.railway.com | sh

If you already have the Railway CLI installed:

railway setup agent

Choose your integration

Railway CLI
Deploys, environments, services, logs, and local development from the terminal.
Railway MCP
Connect through the CLI or OAuth. Works with Cursor, Claude Code, VS Code, Codex, Copilot, Droid, OpenCode, Windsurf, and more.
Agent Skills
The use-railway skill teaches AI coding agents how to operate Railway. Works with Claude Code, Cursor, Codex, OpenCode, Copilot, and Factory Droid.
Cloud agents
Run Claude Code, Codex, or Grok CLI on a persistent Railway VM with your own credentials. Launch from the terminal and reconnect to sessions later.

When to use each

  • Railway MCP — preferred for agent-native operations. The railway mcp command connects to mcp.railway.com and reuses your railway login credentials, and editors that support OAuth can connect directly without the CLI. Exposes the powerful railway-agent tool for multi-step operations. (An in-process local server, railway mcp local, exists for machines that can't reach mcp.railway.com.)
  • Railway CLI — preferred when the task depends on local machine state: current-directory deploys, railway up, railway run, SSH, and local linking.
  • Agent Skills — install alongside any of the above so agents arrive with Railway-specific procedural knowledge instead of guessing.
  • Cloud agents are preferred when the work should outlive the local terminal: a persistent VM running the coding agent, with sessions you can leave and reattach to.