Skip to directory

Railway MCP

Railway

stdio (CLI proxy); Streamable HTTP (direct OAuth)11 documented tools14

About Railway MCP

Connects AI coding clients to Railway projects and hosted infrastructure through Railway's MCP server. The Railway CLI proxy, direct OAuth connection, and in-process local server are distinct connection modes with different tool sets.

What you can use it for

  • Inspect Railway projects, services, environments, deployments and variables
  • Help operate Railway-hosted applications using the account's permissions
Connection and setup
Hosting
Both: Railway-hosted MCP server with CLI stdio proxy, direct remote HTTP OAuth, and in-process local CLI server
Transport
stdio (CLI proxy); Streamable HTTP (direct OAuth)
Endpoint
https://mcp.railway.com
Authentication
CLI login proxy or OAuth.

Requirements

  • Railway account and Railway CLI for CLI/local modes
  • Railway CLI 5.44.0 or later for the default hosted-server proxy
  • An MCP client supporting HTTP OAuth for direct remote mode

Setup steps

  1. Install and authenticate Railway CLI using the official CLI setup guide, then run `railway login`.
  2. Recommended supported-agent setup: run `railway mcp install` (or `railway mcp install --agent codex` for Codex).
  3. For direct remote OAuth, run `railway mcp install --oauth`; the client opens Railway authorization.
  4. For networks that cannot reach the hosted endpoint, run `railway mcp install --local`; this selects the in-process server and its different tool set.
  5. Restart/reload the client if it does not discover the installed configuration. Verify with a read-only request such as listing projects before asking it to change infrastructure.
Tools 11

The hosted Railway MCP lists eleven tools. railway mcp local exposes a distinct local tool set, so counts here apply to the hosted server.

  • whoami

    Return information about the authenticated account.

    01
  • list-projects

    List Railway projects.

    02
  • create-project

    Create a Railway project.

    03
  • list-services

    List services in a project.

    04
  • list-feature-flags

    List feature flags for a project.

    05
  • get-feature-flag

    Get a feature flag by project and flag ID.

    06
  • set-feature-flag

    Set a feature flag value.

    07
  • delete-feature-flag

    Delete a feature flag; admin access required.

    08
  • redeploy

    Redeploy a Railway service.

    09
  • accept-deploy

    Commit staged changes and deploy them.

    10
  • railway-agent

    Delegate a multi-step Railway request to Railway's AI agent.

    11
Limitations and notes
  • Railway MCP can perform infrastructure changes; review and explicitly confirm deployment, deletion, or configuration changes.
  • Hosted and local modes expose different tools.
  • CLI proxy requires Railway CLI 5.44.0 or later for the hosted MCP connection.
Original sources
  • official tool reference

    Current hosted server documents eleven tools. The separate in-process local server has a different tool set; this record follows the hosted server.

  • official documentation

    Current hosted server documents eleven tools. The separate in-process local server has a different tool set; this record follows the hosted server.

Documentation checked 2026-10-28T13:15:00.000Z. Connection has not been runtime tested.

Similar tools