Railway MCP server

Connect Railway to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Railway MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list environments tool in Railway
  • Use the list deployments tool in Railway
  • Use the create environment tool in Railway
  • Use the update volume tool in Railway
  • Use the delete environment tool in Railway
  • Use the rollback deployment tool in Railway

Supported Tools

list_environments

List Environments

List all environments in a Railway project (e.g., production, staging). Each environment maintains its own variables, domains, and deployment configurations.

list_deployments

List Deployments

List deployments for a service in a specific environment. Returns deployment status, URLs, and timestamps. Use this to check deployment history and current status.

create_environment

Create Environment

Create a new environment in a Railway project. Optionally clone from an existing environment to copy its configuration and variables.

update_volume

Update Volume

Rename a persistent storage volume.

delete_environment

Delete Environment

Permanently delete an environment from a Railway project. This removes all environment-specific configurations, variables, and domains. This action cannot be undone.

rollback_deployment

Rollback Deployment

Roll back a service to a previous deployment. The target deployment must support rollback (check canRollback with Get Deployment). Railway creates a new deployment based on the specified one; use List Deployments to follow its progress.

delete_domain

Delete Domain

Remove a domain from a Railway service. Works for both Railway-provided domains and custom domains. Use **isCustom** to specify the domain type.

get_service

Get Service

Retrieve detailed information about a Railway service, including its environment-specific configuration (build settings, deploy settings, replicas, etc.) when an environment ID is provided.

cancel_deployment

Cancel Deployment

Cancel an in-progress deployment. Use this to stop a build or deploy that is currently running.

create_project

Create Project

Create a new Railway project. Optionally assign it to a workspace and set a description.

update_service

Update Service

Update a Railway service's metadata (name, icon) and environment-specific settings (build command, start command, replicas, region, health check, etc.). Provide an environment ID to update environment-specific settings.

set_variables

Set Variables

Create or update one or more environment variables for a service, or shared variables for an environment when serviceId is omitted. Provide variables as key-value pairs. Existing variables with the same name will be overwritten. Use **replaceAll** to remove all existing variables and set only the provided ones.

get_domains

Get Domains

List all domains (both Railway-provided and custom) for a service in a specific environment. Includes DNS record status for custom domains.

delete_project

Delete Project

Permanently delete a Railway project and all its services, environments, and deployments. This action cannot be undone.

trigger_deployment

Trigger Deployment

Trigger a new deployment for a service in a specific environment. Optionally provide a commit SHA for a connected GitHub service.

list_volumes

List Volumes

List all persistent storage volumes in a Railway project. Provide an environment ID to also list the volume instances in that environment (with mount paths, sizes, and the volume instance IDs used by the volume instance and backup tools).

create_volume

Create Volume

Create a new persistent storage volume and attach it to a service. Volumes retain data across deployments. Specify a mount path where the volume will be accessible inside the container.

delete_variable

Delete Variable

Delete a specific environment variable from a service in a given environment, or a shared environment variable when serviceId is omitted.

get_project

Get Project

Retrieve detailed information about a Railway project including its services and environments.

create_domain

Create Domain

Add a domain to a Railway service. Creates either a Railway-provided domain (*.up.railway.app) or attaches a custom domain. For custom domains, DNS records will be provided that must be configured with your DNS provider.

get_variables

Get Variables

Retrieve environment variables for a project and environment. Optionally filter by service to get service-specific variables. Returns the rendered (resolved) variable values.

list_projects

List Projects

List all Railway projects accessible to the authenticated user. Optionally filter by workspace (discover workspace IDs with Get Current User). Returns project names, descriptions, and timestamps, with cursor pagination.

get_deployment_logs

Get Deployment Logs

Retrieve build or runtime logs for a deployment. Use **logType** to specify whether to get build logs (compilation output) or deploy logs (runtime output).

delete_service

Delete Service

Permanently delete a Railway service. This removes all deployments and configuration for the service. This action cannot be undone.

update_project

Update Project

Update an existing Railway project's name, description, or settings like public visibility and PR deploy previews.

get_environment

Get Environment

Get detailed information about an environment including its service instances and their latest deployment status.

create_service

Create Service

Create a new service in a Railway project. Optionally connect it to a GitHub repo or Docker image.

get_deployment

Get Deployment

Get detailed information about a specific deployment, including its status, URLs, metadata, and whether it can be redeployed or rolled back.

delete_volume

Delete Volume

Permanently delete a persistent storage volume. All data stored on the volume will be lost. This action cannot be undone.

remove_deployment

Remove Deployment

Remove a Railway deployment from deployment history.

create_volume_backup

Create Volume Backup

Create a backup for a Railway volume instance. Railway returns a workflow ID for the backup job.

list_volume_backups

List Volume Backups

List backups for a Railway volume instance.

list_regions

List Regions

List Railway deployment regions. Optionally provide a project ID to include project-specific availability.

check_domain_availability

Check Domain Availability

Check whether a custom domain can be added to Railway.

update_custom_domain

Update Custom Domain

Update settings for a Railway custom domain, such as the target service port.

restart_deployment

Restart Deployment

Restart a running Railway deployment without rebuilding it.

get_environment_logs

Get Environment Logs

Retrieve recent logs from all services in a Railway environment.

create_tcp_proxy

Create TCP Proxy

Create a public TCP proxy for a Railway service instance.

get_volume_instance

Get Volume Instance

Get details for a Railway volume instance in a specific environment, including mount path, size, and state.

get_project_members

Get Project Members

List members of a Railway project and their project roles.

get_tcp_proxies

Get TCP Proxies

List TCP proxies configured for a Railway service in an environment.

get_http_logs

Get HTTP Logs

Retrieve HTTP request logs for a Railway deployment, including request path, status, timings, and edge metadata.

stop_deployment

Stop Deployment

Stop a running Railway deployment.

get_domain_status

Get Domain Status

Get DNS verification and certificate status for a Railway custom domain. Find custom domain IDs with Get Domains.

delete_tcp_proxy

Delete TCP Proxy

Delete a Railway TCP proxy.

rename_environment

Rename Environment

Rename a Railway environment.

redeploy_deployment

Redeploy Deployment

Redeploy an existing deployment, rebuilding and redeploying the same source. Returns the new deployment Railway created. The deployment must support redeploys (check canRedeploy with Get Deployment).

get_current_user

Get Current User

Identify the connected Railway credentials. Returns the user profile for account and OAuth tokens, the workspaces the token can access (use these workspace IDs with List Projects and Create Project), and the project and environment for project tokens.

Connect Railway to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Railway in Metorial. In your Metorial portal, enable the Railway MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Railway tools.

Run Railway through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Railway and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Railway tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Railway

Google Sheets

Create, read, and update spreadsheets and their cell data. Read and write values to individual cells, ranges, or multiple ranges using A1 notation or named ranges. Apply cell formatting including text styles, backgrounds, borders, number formats, and conditional formatting. Manage sheets (tabs) within a spreadsheet—add, delete, copy, rename, and reorder them. Create and manage embedded charts, pivot tables, filter views, data validation rules, protected ranges, named ranges, and merged cells. Perform batch operations to apply multiple updates atomically.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Google Drive

Upload, download, create, copy, move, rename, trash, and permanently delete files and folders in Google Drive. Search for files using complex queries filtering by name, MIME type, owner, modification date, labels, and other metadata. Share files and folders with specific users, groups, or domains with role-based permissions (owner, writer, commenter, reader). Manage shared drives and their members. Export Google Workspace files (Docs, Sheets, Slides) to standard formats like PDF, DOCX, and XLSX. Track file revision history and restore earlier versions. Create, read, update, and delete threaded comments and replies on files. Read label definitions and search files by label. Browse the Drive apps installed for your account. Store app-specific data in a hidden per-user folder.

Technical notes for Railway

Deploy and manage web applications, databases, and infrastructure on Railway's cloud platform. Create and configure projects, services, environments, and deployments. Manage environment variables, custom domains, persistent storage volumes, and database services (PostgreSQL, MySQL, MongoDB, Redis).

Frequently asked questions

Common questions about connecting Railway to AI agents with Metorial.

  1. How many tools does the Railway MCP server have?
    The Railway MCP server exposes 48 tools, including List Environments, List Deployments, Create Environment. Each one is governed and traced through Metorial.
  2. Railway exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Railway MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Railway and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Railway MCP server yourself or use the hosted gateway.

Connect Railway to production AI agents

See how Metorial gives your team governed access to Railway, with tracing and security controls built in.