railguey

What it does

railguey is an MCP server that gives AI agents full control over Railway deployments. Create projects, deploy services, check logs, set variables, roll back — all through tool calls without leaving your terminal.

Key features

• Multi-account — manage multiple Railway accounts and workspaces
• Full lifecycle — create projects, services, environments, domains
• Deploy + rollback — push code and roll back if it breaks
• Logs — build logs, deploy logs, HTTP logs with server-side filtering
• Doctor — workspace, service, and project-level health audits
• Variables — set env vars without the dashboard
• TOTP — built-in 2FA for Railway operations that need it

Install

pip install railguey

Usage

# CLI
railguey status ~/repos/my-app
railguey logs ~/repos/my-app web --lines 50
railguey deploy ~/repos/my-app web
railguey doctor ~/repos/my-app

# As MCP — agents call tools directly
railguey_deploy   workspace: "/path" service: "web"
railguey_status   workspace: "/path"
railguey_doctor   workspace: "/path"

17 GraphQL-based tools. Project-scoped tokens — no railway login needed. Same token works in local dev, CI/CD, and AI agents.