Railway Integration

The Railway integration provides access to manage Railway workspaces, projects, services, deployments, variables, domains, and volumes through the Integrate MCP server.

Installation

The Railway integration is included with the SDK:

import { railwayIntegration } from "integrate-sdk/server";

Setup

1. Create a Railway OAuth App

1. Go to Backboard Developer Portal
2. Create a new OAuth application
3. Configure your redirect URI
4. Note your Client ID and Client Secret

2. Configure the Integration on Your Server

Add the Railway integration to your server configuration. The integration automatically reads RAILWAY_CLIENT_ID and RAILWAY_CLIENT_SECRET from your environment variables:

import { createMCPServer, railwayIntegration } from "integrate-sdk/server";

export const { client: serverClient } = createMCPServer({
  apiKey: process.env.INTEGRATE_API_KEY,
  integrations: [
    railwayIntegration({
      scopes: ["openid", "profile", "email", "workspace:admin", "project:member"], // Optional
    }),
  ],
});

You can override the environment variables by passing explicit values:

railwayIntegration({
  clientId: process.env.CUSTOM_RAILWAY_ID,
  clientSecret: process.env.CUSTOM_RAILWAY_SECRET,
      scopes: ["openid", "profile", "email", "workspace:admin", "project:member"], // Optional
});

3. Client-Side Usage

The default client automatically includes all integrations. You can use it directly:

import { client } from "integrate-sdk";

await client.authorize("railway");
const result = await client.railway.getCurrentUser({});

console.log(result);

If you're using a custom client, add the integration to the integrations array:

import { createMCPClient, railwayIntegration } from "integrate-sdk";

const customClient = createMCPClient({
  integrations: [railwayIntegration()],
});

Configuration Options

Default Scopes

These defaults are applied unless you override scopes in the integration config:

• openid
• profile
• email
• workspace:admin
• project:member

Tools

railway_get_current_user

Get current user

No parameters.

railway_get_workspace

Get workspace

railway_list_regions

List regions

No parameters.

railway_list_projects

List projects

railway_get_project

Get project

railway_create_project

Create project

railway_update_project

Update project

railway_delete_project

Delete project

railway_transfer_project

Transfer project

railway_list_project_members

List project members

railway_list_environments

List environments

railway_get_environment

Get environment

railway_create_environment

Create environment

railway_rename_environment

Rename environment

railway_delete_environment

Delete environment

railway_get_environment_logs

Get environment logs

railway_get_environment_staged_changes

Get environment staged changes

railway_commit_environment_staged_changes

Commit environment staged changes

railway_get_service

Get service

railway_get_service_instance

Get service instance

railway_create_service

Create service

railway_update_service

Update service

railway_update_service_instance

Update service instance

railway_connect_service

Connect service

railway_disconnect_service

Disconnect service

railway_deploy_service

Deploy service

railway_redeploy_service

Redeploy service

railway_get_service_limits

Get service limits

railway_delete_service

Delete service

railway_list_deployments

List deployments

railway_get_deployment

Get deployment

railway_get_latest_active_deployment

Get latest active deployment

railway_get_deployment_build_logs

Get deployment build logs

railway_get_deployment_runtime_logs

Get deployment runtime logs

railway_get_deployment_http_logs

Get deployment http logs

railway_redeploy_deployment

Redeploy deployment

railway_restart_deployment

Restart deployment

railway_rollback_deployment

Rollback deployment

railway_stop_deployment

Stop deployment

railway_cancel_deployment

Cancel deployment

railway_remove_deployment

Remove deployment

railway_get_variables

Get variables

railway_get_unrendered_variables

Get unrendered variables

railway_upsert_variable

Upsert variable

railway_upsert_variables

Upsert variables

railway_delete_variable

Delete variable

railway_get_rendered_variables

Get rendered variables

railway_list_domains

List domains

railway_create_service_domain

Create service domain

railway_delete_service_domain

Delete service domain

railway_check_custom_domain_availability

Check custom domain availability

railway_create_custom_domain

Create custom domain

railway_get_custom_domain_status

Get custom domain status

railway_update_custom_domain

Update custom domain

railway_delete_custom_domain

Delete custom domain

railway_list_project_volumes

List project volumes

railway_get_volume_instance

Get volume instance

railway_create_volume

Create volume

railway_update_volume

Update volume

railway_update_volume_instance

Update volume instance

railway_delete_volume

Delete volume

railway_list_volume_backups

List volume backups

railway_create_volume_backup

Create volume backup

railway_restore_volume_backup

Restore volume backup

railway_lock_volume_backup

Lock volume backup

railway_delete_volume_backup

Delete volume backup

railway_list_volume_backup_schedules

List volume backup schedules

railway_list_tcp_proxies

List tcp proxies

Notes

• Category: Infrastructure
• Authentication mode: OAuth