Railway MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Railway MCP or direct API to inspect projects, manage services, track deployments, and review environments through natural language.

Railway logoRailway
Api KeyOauth2

Railway is a deployment platform for building, shipping, and scaling applications with managed infrastructure. It helps teams deploy faster with instant builds, automatic scaling, and simple project operations.

18 Tools

Try Railway now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Railway
Try asking
TOOLS

Supported Tools

Every Railway action and event your agent gets out of the box.

Create Plugin

Creates a new plugin in Railway for the specified project.

Delete Variable

Delete a Railway environment variable.

Delete Volume

Permanently delete a persistent volume and all its associated data from Railway.

Delete workspace

Delete a Railway workspace and all data associated with it.

Disconnect Discord account

Disconnects the authenticated user's Railway account from Discord.

Get Deployment Logs

Retrieve runtime logs for a deployment.

Get Environment

Get details of a specific Railway environment by its ID, including service instances and deployment information.

Get GitHub PR Info

Get information for a GitHub pull request associated with a Railway service.

Get User Kickback Earnings

Get the total kickback earnings for the authenticated Railway user.

List API Tokens

Retrieve all API tokens for the authenticated user from Railway.

List Environment Patches

Retrieve all patches for a Railway environment using the GraphQL API.

List GitHub Repos

Retrieve a list of GitHub repositories that Railway has access to.

List GitHub Writable Scopes

Retrieve the list of GitHub scopes the user has installed the installation to.

List Integration Auths

Retrieve all integration auths for the authenticated user from Railway.

List Notification Deliveries

Retrieve notification deliveries for the authenticated user.

List Railway Trusted Domains

Fetch all trusted domains for the authenticated Railway workspace.

Update Project

Update project settings and configuration on Railway.

Update Service Instance

Update build/deploy settings for a service in a specific environment on Railway.

SETUP GUIDE

Connect Railway MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Railway
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Check the latest Railway deployment status for my production service'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Railway API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Railway Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'List recent failed deployments in my Railway project'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Railway actions with your Agent

Why Use Composio?

AI Native Railway Integration

  • Supports both Railway MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable Railway project and deployment actions
  • Rich coverage for reading, writing, and querying Railway resources like services, environments, and deployments

Managed Auth

  • Handles Railway API key and OAuth based authentication flows securely
  • Central place to manage, scope, and revoke Railway access
  • Per user and per environment credentials instead of hard-coded keys in your agent code

Agent Optimized Design

  • Railway tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what Railway action ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Railway
  • Scoped, least privilege access to Railway projects, services, and environments
  • Full audit trail of agent actions to support review and compliance
FRAMEWORKS

Use Railway with any AI Agent Framework

Choose a Framework you want to connect Railway with

FAQ

Frequently asked questions

Yes, Railway requires you to configure your own API key. Once set up, Composio handles secure credential storage and API request handling for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Railway.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Railway tool your agent needs.Free to start.

Start building