KosmoKrator

productivity

Railway MCP Integration for OpenAI Agents SDK

Connect Railway to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

7 functions 6 read 1 write Bearer token auth
Submit Railway feedback View package source

Connect Railway to OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

Railway MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "mcpServers": {
    "kosmokrator-railway": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=railway",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=railway --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Railway instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Railway Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the Railway integration catalog.

MCP toolSource functionTypeDescription
integration__railway__railway_list_projects railway.railway_list_projects Read List all Railway projects the authenticated user has access to. Returns project IDs, names, descriptions, and team info.
integration__railway__railway_get_project railway.railway_get_project Read Get detailed information about a specific Railway project, including its environments and plugins.
integration__railway__railway_create_project railway.railway_create_project Write Create a new Railway project with a name and optional description.
integration__railway__railway_list_services railway.railway_list_services Read List all services in a Railway project. Returns service IDs, names, and repository info.
integration__railway__railway_get_service railway.railway_get_service Read Get detailed information about a specific Railway service, including its source configuration and repository details.
integration__railway__railway_list_deployments railway.railway_list_deployments Read List deployments for a Railway service. Returns deployment status, environment, and creator info.
integration__railway__railway_get_current_user railway.railway_get_current_user Read Get information about the currently authenticated Railway user. Useful for verifying API credentials.

Related Railway Pages

Railway CLIUse direct JSON commands instead of MCP discovery. Railway MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.