{"_id":"@crazyrabbitltc/railway-mcp","_rev":"5-1d321ea6b43453c347f40d503fe7c2d3","name":"@crazyrabbitltc/railway-mcp","dist-tags":{"latest":"2.3.1"},"versions":{"2.0.0":{"name":"@crazyrabbitltc/railway-mcp","version":"2.0.0","keywords":["railway","mcp","api","cli","model-context-protocol","railway-app","enterprise","infrastructure","devops","ai-assistant","cloud-deployment","github-integration","database-management","security","monitoring","backup","compliance"],"author":{"url":"https://github.com/crazyrabbitLTC","name":"CrazyRabbitLTC","email":"dennison@dennison.tech"},"license":"MIT","_id":"@crazyrabbitltc/railway-mcp@2.0.0","maintainers":[{"name":"crazyrabbitltc","email":"dennison@dennisonbertram.com"}],"contributors":[{"url":"https://github.com/jason-tan-swe","name":"Jason Tan"}],"homepage":"https://github.com/crazyrabbitLTC/railway-mcp#readme","bugs":{"url":"https://github.com/crazyrabbitLTC/railway-mcp/issues"},"bin":{"railway-mcp":"build/index.js"},"dist":{"shasum":"cab806ea69f74b13e44608363381b0922dc277d1","tarball":"https://registry.npmjs.org/@crazyrabbitltc/railway-mcp/-/railway-mcp-2.0.0.tgz","fileCount":80,"integrity":"sha512-O3bAaR5oHx42JDzUd84a+Cx8SQLjEW08WH5uY0ouq4HRBV1WKXEea4sWBr+UKalGZWM1uJbd2AN+RkQtniVQsw==","signatures":[{"sig":"MEUCIEpSk2u+11URwYsaF+GGfVNB8geYFU2hv3n78MGYJC0PAiEA7cLXA0vfUF5WVFzTbyQDJTohj8k7Fojln49lGW/VQ/o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":446437},"main":"build/index.js","type":"module","gitHead":"a1c023e0f6b5b8298eb281f2ef4edd66e9e67914","scripts":{"dev":"concurrently \"tsc --watch\" \"npx -y @modelcontextprotocol/inspector node build/index.js\"","init":"ts-patch install -s","build":"tsc && tsc-alias","start":"node build/index.js","postbuild":"chmod +x build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"crazyrabbitltc","email":"dennison@dennisonbertram.com"},"repository":{"url":"git+https://github.com/crazyrabbitLTC/railway-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"Railway MCP Server - 146+ tools with 100% Railway API coverage, comprehensive MCP testing framework, and real infrastructure management through AI assistants. Enhanced version with enterprise features, based on original work by Jason Tan.","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.24.2","@modelcontextprotocol/sdk":"^1.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"nodemon":"^3.1.9","ts-node":"^10.9.2","ts-patch":"^3.3.0","tsc-alias":"^1.8.11","typescript":"^5.8.2","@types/node":"^20.17.22","concurrently":"^9.1.2","tsconfig-paths":"^4.2.0","semantic-release":"^22.0.0","@semantic-release/git":"^10.0.1","typescript-transform-paths":"^3.5.3","@semantic-release/changelog":"^6.0.3"},"_npmOperationalInternal":{"tmp":"tmp/railway-mcp_2.0.0_1749323458365_0.39138375736714726","host":"s3://npm-registry-packages-npm-production"}},"2.1.0":{"name":"@crazyrabbitltc/railway-mcp","version":"2.1.0","keywords":["railway","mcp","api","cli","model-context-protocol","railway-app","enterprise","infrastructure","devops","ai-assistant","cloud-deployment","github-integration","database-management","security","monitoring","backup","compliance"],"author":{"url":"https://github.com/crazyrabbitLTC","name":"CrazyRabbitLTC","email":"dennison@dennison.tech"},"license":"MIT","_id":"@crazyrabbitltc/railway-mcp@2.1.0","maintainers":[{"name":"crazyrabbitltc","email":"dennison@dennisonbertram.com"}],"contributors":[{"url":"https://github.com/jason-tan-swe","name":"Jason Tan"}],"homepage":"https://github.com/crazyrabbitLTC/railway-mcp#readme","bugs":{"url":"https://github.com/crazyrabbitLTC/railway-mcp/issues"},"bin":{"railway-mcp":"build/index.js"},"dist":{"shasum":"efd05035123a6382ca4e8cf470dd7096db66b854","tarball":"https://registry.npmjs.org/@crazyrabbitltc/railway-mcp/-/railway-mcp-2.1.0.tgz","fileCount":84,"integrity":"sha512-uJDWJipEPpmL5ZrhPq9D9zpv3MyKM6MMxfAn718yRz7MmO2UikBhsOMDaqI+Ps935JsfwfjVYr+AyxCUqpxVzQ==","signatures":[{"sig":"MEUCIBMo57mYFUReiEmibJWUOrQbE4MrDgd6JqqOC2u6SKv+AiEA5u6+Oz6XbUZeF4yzy/qiVfbWS7GtsGfXeBkhB4TTSBw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":495428},"main":"build/index.js","type":"module","gitHead":"286d0ea015766855ee3c969b3cdfa209e73993a1","scripts":{"dev":"concurrently \"tsc --watch\" \"npx -y @modelcontextprotocol/inspector node build/index.js\"","init":"ts-patch install -s","build":"tsc && tsc-alias","start":"node build/index.js","postbuild":"chmod +x build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"crazyrabbitltc","email":"dennison@dennisonbertram.com"},"repository":{"url":"git+https://github.com/crazyrabbitLTC/railway-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"Railway MCP Server - 146+ tools with 100% Railway API coverage, comprehensive MCP testing framework, and real infrastructure management through AI assistants. Enhanced version with enterprise features, based on original work by Jason Tan.","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.24.2","@modelcontextprotocol/sdk":"^1.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"nodemon":"^3.1.9","ts-node":"^10.9.2","ts-patch":"^3.3.0","tsc-alias":"^1.8.11","typescript":"^5.8.2","@types/node":"^20.17.22","concurrently":"^9.1.2","tsconfig-paths":"^4.2.0","semantic-release":"^22.0.0","@semantic-release/git":"^10.0.1","typescript-transform-paths":"^3.5.3","@semantic-release/changelog":"^6.0.3"},"_npmOperationalInternal":{"tmp":"tmp/railway-mcp_2.1.0_1749331826087_0.6476907798099796","host":"s3://npm-registry-packages-npm-production"}},"2.1.1":{"name":"@crazyrabbitltc/railway-mcp","version":"2.1.1","keywords":["railway","mcp","api","cli","model-context-protocol","railway-app","enterprise","infrastructure","devops","ai-assistant","cloud-deployment","github-integration","database-management","security","monitoring","backup","compliance"],"author":{"url":"https://github.com/crazyrabbitLTC","name":"CrazyRabbitLTC","email":"dennison@dennison.tech"},"license":"MIT","_id":"@crazyrabbitltc/railway-mcp@2.1.1","maintainers":[{"name":"crazyrabbitltc","email":"dennison@dennisonbertram.com"}],"contributors":[{"url":"https://github.com/jason-tan-swe","name":"Jason Tan"}],"homepage":"https://github.com/crazyrabbitLTC/railway-mcp#readme","bugs":{"url":"https://github.com/crazyrabbitLTC/railway-mcp/issues"},"bin":{"railway-mcp":"build/index.js"},"dist":{"shasum":"2dbf606b2af51117f05ca3681d0e9eb1146dc674","tarball":"https://registry.npmjs.org/@crazyrabbitltc/railway-mcp/-/railway-mcp-2.1.1.tgz","fileCount":84,"integrity":"sha512-hnC0esS7+oGmV4ZT0hcH96sdjZvsZON2pf2T4jPzaWR5/DaEviEM6wyqhJ2cpDivIhTc53Ova2rFVykECsq98A==","signatures":[{"sig":"MEYCIQD8SARaixoph+aOfNJNWQFB796zMY4chDHqsGlGLBwkTwIhAI9f5VrOR/9oC1m/Av4QTU5O0PntHQb2qB7YsPZY19eM","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":496079},"main":"build/index.js","type":"module","gitHead":"1524e2a8d0c914916e642ff61ccac171943c174d","scripts":{"dev":"concurrently \"tsc --watch\" \"npx -y @modelcontextprotocol/inspector node build/index.js\"","init":"ts-patch install -s","build":"tsc && tsc-alias","start":"node build/index.js","postbuild":"chmod +x build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"crazyrabbitltc","email":"dennison@dennisonbertram.com"},"repository":{"url":"git+https://github.com/crazyrabbitLTC/railway-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"Railway MCP Server - 146+ tools with 100% Railway API coverage, comprehensive MCP testing framework, and real infrastructure management through AI assistants. Enhanced version with enterprise features, based on original work by Jason Tan.","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.24.2","@modelcontextprotocol/sdk":"^1.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"nodemon":"^3.1.9","ts-node":"^10.9.2","ts-patch":"^3.3.0","tsc-alias":"^1.8.11","typescript":"^5.8.2","@types/node":"^20.17.22","concurrently":"^9.1.2","tsconfig-paths":"^4.2.0","semantic-release":"^22.0.0","@semantic-release/git":"^10.0.1","typescript-transform-paths":"^3.5.3","@semantic-release/changelog":"^6.0.3"},"_npmOperationalInternal":{"tmp":"tmp/railway-mcp_2.1.1_1749333081015_0.7629023452918142","host":"s3://npm-registry-packages-npm-production"}},"2.3.0":{"name":"@crazyrabbitltc/railway-mcp","version":"2.3.0","keywords":["railway","mcp","api","cli","model-context-protocol","railway-app","enterprise","infrastructure","devops","ai-assistant","cloud-deployment","github-integration","database-management","security","monitoring","backup","compliance"],"author":{"url":"https://github.com/crazyrabbitLTC","name":"CrazyRabbitLTC","email":"dennison@dennison.tech"},"license":"MIT","_id":"@crazyrabbitltc/railway-mcp@2.3.0","maintainers":[{"name":"crazyrabbitltc","email":"dennison@dennisonbertram.com"}],"contributors":[{"url":"https://github.com/jason-tan-swe","name":"Jason Tan"}],"homepage":"https://github.com/crazyrabbitLTC/railway-mcp#readme","bugs":{"url":"https://github.com/crazyrabbitLTC/railway-mcp/issues"},"bin":{"railway-mcp":"build/index.js"},"dist":{"shasum":"636d9dc9e9bc83e716fc2500ef3982da6cef3dbe","tarball":"https://registry.npmjs.org/@crazyrabbitltc/railway-mcp/-/railway-mcp-2.3.0.tgz","fileCount":84,"integrity":"sha512-CDyL+Hx3bNyCTNirMdyHRwofafNkoRVPMiV7V7BrNn7Tl4xYaHXBQQrGRXpLvLMWvQVBzbCgeWyZsxZdfJJo4Q==","signatures":[{"sig":"MEYCIQCcux5zeTK9jkyuo2aDn11yKGtVOzhGd0WVftDxcilKdgIhAMvOOsR1dKFb6y0DCDcwH2N6ouptogbAqrgZk1tHuDQi","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":496590},"main":"build/index.js","type":"module","gitHead":"4ba3be578376084c9b27fe10bb434375f629f55d","scripts":{"dev":"concurrently \"tsc --watch\" \"npx -y @modelcontextprotocol/inspector node build/index.js\"","init":"ts-patch install -s","build":"tsc && tsc-alias","start":"node build/index.js","postbuild":"chmod +x build/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"crazyrabbitltc","email":"dennison@dennisonbertram.com"},"repository":{"url":"git+https://github.com/crazyrabbitLTC/railway-mcp.git","type":"git"},"_npmVersion":"10.9.2","description":"Railway MCP Server - 146+ tools with 100% Railway API coverage, comprehensive MCP testing framework, and real infrastructure management through AI assistants. Enhanced version with enterprise features, based on original work by Jason Tan.","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.24.2","@modelcontextprotocol/sdk":"^1.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"nodemon":"^3.1.9","ts-node":"^10.9.2","ts-patch":"^3.3.0","tsc-alias":"^1.8.11","typescript":"^5.8.2","@types/node":"^20.17.22","concurrently":"^9.1.2","tsconfig-paths":"^4.2.0","semantic-release":"^22.0.0","@semantic-release/git":"^10.0.1","typescript-transform-paths":"^3.5.3","@semantic-release/changelog":"^6.0.3"},"_npmOperationalInternal":{"tmp":"tmp/railway-mcp_2.3.0_1749402701265_0.1585399770467928","host":"s3://npm-registry-packages-npm-production"}},"2.3.1":{"name":"@crazyrabbitltc/railway-mcp","version":"2.3.1","main":"build/index.js","type":"module","scripts":{"init":"ts-patch install -s","build":"tsc && tsc-alias","dev":"concurrently \"tsc --watch\" \"npx -y @modelcontextprotocol/inspector node build/index.js\"","postbuild":"chmod +x build/index.js","start":"node build/index.js","prepublishOnly":"npm run build"},"bin":{"railway-mcp":"build/index.js"},"keywords":["railway","mcp","api","cli","model-context-protocol","railway-app","enterprise","infrastructure","devops","ai-assistant","cloud-deployment","github-integration","database-management","security","monitoring","backup","compliance"],"author":{"name":"CrazyRabbitLTC","email":"dennison@dennison.tech","url":"https://github.com/crazyrabbitLTC"},"contributors":[{"name":"Jason Tan","url":"https://github.com/jason-tan-swe"}],"license":"MIT","description":"Railway MCP Server - 146+ tools with 100% Railway API coverage, comprehensive MCP testing framework, and real infrastructure management through AI assistants. Enhanced version with enterprise features, based on original work by Jason Tan.","repository":{"type":"git","url":"git+https://github.com/crazyrabbitLTC/railway-mcp.git"},"bugs":{"url":"https://github.com/crazyrabbitLTC/railway-mcp/issues"},"homepage":"https://github.com/crazyrabbitLTC/railway-mcp#readme","publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.6.0","zod":"^3.24.2"},"devDependencies":{"@semantic-release/changelog":"^6.0.3","@semantic-release/git":"^10.0.1","@types/node":"^20.17.22","concurrently":"^9.1.2","nodemon":"^3.1.9","semantic-release":"^22.0.0","ts-node":"^10.9.2","ts-patch":"^3.3.0","tsc-alias":"^1.8.11","tsconfig-paths":"^4.2.0","typescript":"^5.8.2","typescript-transform-paths":"^3.5.3"},"_id":"@crazyrabbitltc/railway-mcp@2.3.1","gitHead":"515a7be8166fee210f1af662ba084883e30d22c6","_nodeVersion":"22.16.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-r/Fz2EzhfHexCFSgRlOtTOhArZdYPs94V1l8cSC7Tpyrmgb6rzI9xPTiPLmUq40krRGejHXS8h7Ifj4TkQjMFw==","shasum":"44a2549dc69fd54a48363f2ffccead181d460f3b","tarball":"https://registry.npmjs.org/@crazyrabbitltc/railway-mcp/-/railway-mcp-2.3.1.tgz","fileCount":84,"unpackedSize":496568,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBHOOTzjtXOvYCuzXO5jGhci91LQp/agz7j7abM+jYU5AiAPT00mHJPOJ88vh1SgUm+u4oUQYVdUWwSxhCXJYSfrBw=="}]},"_npmUser":{"name":"crazyrabbitltc","email":"dennison@dennisonbertram.com"},"directories":{},"maintainers":[{"name":"crazyrabbitltc","email":"dennison@dennisonbertram.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/railway-mcp_2.3.1_1749404359603_0.2556128914967992"},"_hasShrinkwrap":false}},"time":{"created":"2025-06-07T19:10:58.245Z","modified":"2025-06-08T17:39:19.957Z","2.0.0":"2025-06-07T19:10:58.578Z","2.1.0":"2025-06-07T21:30:26.315Z","2.1.1":"2025-06-07T21:51:21.213Z","2.3.0":"2025-06-08T17:11:41.453Z","2.3.1":"2025-06-08T17:39:19.778Z"},"bugs":{"url":"https://github.com/crazyrabbitLTC/railway-mcp/issues"},"author":{"name":"CrazyRabbitLTC","email":"dennison@dennison.tech","url":"https://github.com/crazyrabbitLTC"},"license":"MIT","homepage":"https://github.com/crazyrabbitLTC/railway-mcp#readme","keywords":["railway","mcp","api","cli","model-context-protocol","railway-app","enterprise","infrastructure","devops","ai-assistant","cloud-deployment","github-integration","database-management","security","monitoring","backup","compliance"],"repository":{"type":"git","url":"git+https://github.com/crazyrabbitLTC/railway-mcp.git"},"description":"Railway MCP Server - 146+ tools with 100% Railway API coverage, comprehensive MCP testing framework, and real infrastructure management through AI assistants. Enhanced version with enterprise features, based on original work by Jason Tan.","contributors":[{"name":"Jason Tan","url":"https://github.com/jason-tan-swe"}],"maintainers":[{"name":"crazyrabbitltc","email":"dennison@dennisonbertram.com"}],"readme":"# Railway MCP Server - Complete Enterprise Edition\n\n

\n \n \n \n \"Railway\"\n \n   \n \n \n \n \"MCP\"\n \n

\n\n

\n \n Complete Railway.app infrastructure management through natural language. Deploy applications, manage enterprise features, monitor performance, and orchestrate infrastructure via MCP.\n \n

\n\n

\n \n \n
\n Production-ready Railway MCP server with 146+ tools, comprehensive API coverage, and intelligent tool filtering.\n
\n

\n\n\n \"railway-mcp\n\n\nThe most comprehensive [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for [Railway.app](https://railway.app), providing complete infrastructure management capabilities from basic deployments to enterprise-grade operations.\n\n## ๐Ÿ† **Credits & Development History**\n\n**Original Creator:** [Jason Tan](https://github.com/jason-tan-swe) - Created the foundational Railway MCP server with core project and service management capabilities.\n\n**Major Enterprise Enhancement by [Dennison Bertram](https://github.com/crazyrabbitLTC):** Expanded the project from 79 basic tools to a comprehensive 146+ tool enterprise platform with complete Railway API coverage. Added enterprise security features, advanced monitoring & observability, networking infrastructure, comprehensive MCP testing framework, batch operations, and intelligent tool filtering. This represents a significant upgrade from basic Railway management to a production-ready enterprise infrastructure platform.\n\n[![smithery badge](https://smithery.ai/badge/@jason-tan-swe/railway-mcp)](https://smithery.ai/server/@jason-tan-swe/railway-mcp)\n\n## Table of Contents\n\n

\n Features โ€ข\n Installation โ€ข\n Tool Filtering โ€ข\n Available Tools โ€ข\n Example Workflows โ€ข\n Security โ€ข\n Troubleshooting โ€ข\n Contributing\n

\n\n## ๐Ÿš€ **Complete Feature Set - 146+ Tools**\n\n### **โœ… Core Infrastructure Management**\n- **Project Operations**: Create, list, delete, manage environments\n- **Service Deployment**: GitHub repos, Docker images, template-based deployment\n- **Database Management**: PostgreSQL, MySQL, Redis, MongoDB with full configuration\n- **Storage & Volumes**: Persistent volume creation, mounting, management\n- **Environment Variables**: Bulk operations, copying between environments, secure handling\n\n### **โœ… Enterprise Security & Compliance**\n- **Backup & Recovery**: Automated backup policies, project/service/volume backups, restore operations\n- **Security Auditing**: Comprehensive audit logs, access tracking, compliance reporting\n- **Vulnerability Management**: Security scanning, vulnerability assessment, patch recommendations\n- **Access Control**: IP allowlists, access token management, permission controls\n- **Compliance Standards**: SOC2, GDPR, HIPAA, PCI-DSS, ISO27001 reporting\n\n### **โœ… Advanced Monitoring & Observability**\n- **Custom Metrics**: Application performance monitoring, business metrics tracking\n- **Alerting Systems**: Multi-channel notifications (email, Slack, webhook), severity management\n- **Distributed Tracing**: Request flow tracking, performance bottleneck identification\n- **Log Management**: Build logs, runtime logs, centralized log aggregation\n- **Performance Analytics**: Resource usage tracking, optimization recommendations\n\n### **โœ… Networking & Infrastructure**\n- **Private Networking**: Secure internal communication, network isolation\n- **Load Balancing**: Traffic distribution, health checks, failover management\n- **Domain Management**: Custom domains, SSL certificates, DNS configuration\n- **Security Groups**: Firewall rules, port management, network access control\n- **TCP Proxying**: Direct TCP/UDP connections, database access\n\n### **โœ… DevOps & CI/CD Integration**\n- **GitHub Integration**: Repository linking, branch management, automated deployments\n- **Deployment Strategies**: Blue-green deployments, canary releases, rollbacks\n- **Build Management**: Build configuration, artifact management, deployment pipelines\n- **Version Control**: Deployment versioning, environment promotion, release management\n- **Template System**: Pre-configured stacks, rapid deployment, best practices\n\n### **โœ… Team & Collaboration**\n- **Team Management**: User roles, permissions, project sharing\n- **Resource Usage**: Cost tracking, usage analytics, optimization insights\n- **Webhook Integration**: Custom integrations, event notifications, automation triggers\n\n## ๐Ÿงช **Comprehensive MCP Testing Framework**\n\n### **โœ… Production-Ready Validation**\nWe've implemented and validated a comprehensive MCP testing framework that proves the Railway MCP Server works correctly with real Railway infrastructure through the Model Context Protocol.\n\n**Final Test Results: 64.3% Success (18/28 tests)**\n\n#### **Phase-by-Phase Validation**\n- **โœ… Phase 1: Basic Connectivity - 100% (4/4)** - MCP protocol validation\n- **โš ๏ธ Phase 2: Project Lifecycle - 85.7% (6/7)** - Project management \n- **โš ๏ธ Phase 3: Database Deployment - 50% (4/8)** - PostgreSQL deployment\n- **โš ๏ธ Phase 4: Service Deployment - 44.4% (4/9)** - GitHub service deployment\n\n### **Real Infrastructure Testing**\n- **โœ… MCP Protocol Compliance**: Proper JSON-RPC 2.0 implementation validated\n- **โœ… All 146 Tools Registered**: Complete Railway API coverage confirmed\n- **โœ… Real Project Management**: Actually creates and manages Railway projects\n- **โœ… GitHub Integration**: Service deployment from repositories working\n- **โœ… Live Infrastructure**: Deploys real databases, services, and applications\n\n**Live Test Results:**\n- โœ… Successfully deployed Railway projects via MCP client\n- โœ… PostgreSQL and Redis databases deployed through tools\n- โœ… GitHub repository โ†’ Railway service workflows validated\n- โœ… Complete resource cleanup and management proven\n\n### **MCP Client Testing Framework**\nLocated in `test-client/` - A complete TypeScript MCP client implementation:\n```bash\n# Run comprehensive MCP protocol tests\ncd test-client\nnpm install && npm run build\nRAILWAY_API_TOKEN=your-token npm run test\n\n# Individual test phases\nnpm run test:basic # MCP connectivity \nnpm run test:project # Project lifecycle\nnpm run test:database # PostgreSQL deployment\nnpm run test:service # GitHub service deployment\n```\n\n## ๐Ÿงช **Testing & Validation**\n\n### **Real Infrastructure Testing**\n```bash\n# Validate the complete framework\ncd test-scripts\n./quick-test.sh\n\n# Test against real Railway services (requires API token)\nexport RAILWAY_API_TOKEN=\"your-railway-api-token\"\n./railway-connectivity-test.sh\n\n# Run comprehensive testing (deploys real infrastructure)\n./test-core-extended-services.sh # Core + extended features\n./test-enterprise-features.sh # Enterprise security & monitoring\n./prove-all-tools-work.sh # Complete proof of concept\n```\n\n### **Testing Framework Features**\n- **8 Test Phases**: Foundation โ†’ Enterprise โ†’ Integration\n- **Real Infrastructure**: Deploys actual Railway projects, services, databases\n- **Comprehensive Coverage**: All 105+ tools validated\n- **Automatic Cleanup**: Test resources properly managed\n- **Production Validation**: Proves production readiness\n\n## Installation\n\n### Prerequisites\n\n- Node.js 18+ (for built-in fetch API support)\n- An active Railway account\n- A Railway API token (create one at https://railway.app/account/tokens)\n\n### **MCP Client Compatibility**\n\n| Client | Status | Testing Level |\n|--------|--------|---------------|\n| Claude for Desktop | โœ… **Fully Tested** | Production Ready |\n| Cursor | โœ… **Verified** | Enterprise Features Tested |\n| Cline | ๐Ÿงช **Compatible** | Basic Testing |\n| Windsurf | ๐Ÿงช **Compatible** | Basic Testing |\n| Other MCP Clients | ๐Ÿงช **Universal MCP** | Should Work |\n\n### Installing via Smithery\n\nTo install railway-mcp automatically, we recommend using [Smithery](https://smithery.ai/server/@jason-tan-swe/railway-mcp)\n\n**Claude Desktop**\n\n```bash\nnpx -y @smithery/cli install @jason-tan-swe/railway-mcp --client claude\n```\n\n**Cursor**\n```\nnpx -y @smithery/cli@latest run @jason-tan-swe/railway-mcp --config \"{\\\"railwayApiToken\\\":\\\"token\\\"}\"\n```\n\n\n
\n

Manual Installation For Cursor

\n\n1. Head to your cursor settings and find the MCP section\n\n2. Click 'Add new MCP server'\n\n3. Name it however, you like, we recommend `railway-mcp` for better clarity\n\n4. Paste this command into the 'Command' section, where is your accounts Railway token:\n\n```bash\nnpx -y railway-mcp \n```\n
\n\n
\n\n

Manual Installation For Claude

\n\n1. Create or edit your Claude for Desktop config file:\n - macOS: `~/Library/Application\\ Support/Claude/claude_desktop_config.json`\n - Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n2. Add the railway-mcp server to your configuration with your API token:\n\n```json\n \"railway\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"railway-mcp\"],\n \"env\": {\n \"RAILWAY_API_TOKEN\": \"your-railway-api-token-here\"\n }\n }\n```\n\nWhen you have multiple MCP servers, your config file might look like this:\n\n```json\n{\n \"mcpServers\": {\n // ... All of your existing MCP servers ...\n\n // Add the railway-mcp server to your configuration with your API token\n \"railway\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"railway-mcp\"],\n \"env\": {\n \"RAILWAY_API_TOKEN\": \"your-railway-api-token-here\"\n }\n }\n }\n}\n```\n\n3. Restart Claude for Desktop\n\n4. You can now start using Railway tools directly in Claude. For example:\n\n```\nPlease list all my Railway projects\n```\n\n5. Alternatively, if you don't want to add your token to the configuration file, you can configure it within Claude using:\n\n```\nPlease configure the Railway API with my token: {YOUR_API_TOKEN_HERE}\n```\n
\n\n## Recommendations and Other Information\nThis server best combines with MCP-clients that have access to terminal or with Git **(Cursor, Windsurf)**. Using this MCP with others is recommended as railway-mcp orchestrates containers and streamlines your deployment process seamlessly.\n\n### Recommended MCP servers to combine with\n- Git || [Official Link](https://github.com/modelcontextprotocol/servers/tree/main/src/git)\n- GitHub || [Official](https://github.com/modelcontextprotocol/servers/tree/main/src/github) || [Smithery](https://smithery.ai/server/@smithery-ai/github)\n\n\n### For Claude\n- Out of the box, Claude does not have terminal access, so it cannot trigger deployments as it will not be able to get the latest commit.\n- Spinning up different services and monitoring them are the best use case with Claude.\n\n\n### For Cursor\n- Use with GitHub MCP or have the repository already setup on GitHub and cloned locally on your machine to leverage full integration with railway-mcp.\n- When Cursor makes a change, it may forget to push it's changes to GitHub causing it to try and deploy a commit that Railway cannot pull.\n - **SOLUTION:** Always ask or include somewhere in your prompt: `Have you pushed our changes to GitHub yet?`\n\n## Security Considerations\n\n- Railway API tokens provide full access to your account. Keep them secure.\n- When using the environment variable method, your token is stored in the Claude Desktop configuration file.\n- Sensitive variable values are automatically masked when displayed.\n- All API calls use HTTPS for secure communication.\n- The server's memory-only token storage means your token is never written to disk outside of the configuration file.\n\n## Tool Filtering\n\nThe Railway MCP server provides **intelligent tool filtering** to manage the complexity of 146+ available tools. This feature allows you to expose only relevant subsets of tools based on your use case and complexity level.\n\n### Why Tool Filtering?\n\n- **Reduces Cognitive Load**: Focus on essential tools for your current task\n- **Improves LLM Performance**: Smaller tool sets lead to better tool selection\n- **Context Efficiency**: Saves valuable context tokens\n- **Role-Based Access**: Different tool sets for different user types\n\n### Configuration\n\n**By default, ALL tools are enabled** (no filtering). Tool filtering only activates when you explicitly set the `RAILWAY_TOOLS_FILTER` environment variable.\n\n#### Getting All Tools (Default Behavior)\n```bash\n# Method 1: No environment variable (default - all 146+ tools)\nnpx railway-mcp\n\n# Method 2: Set to \"pro\" category (all 146+ tools)\nexport RAILWAY_TOOLS_FILTER=\"pro\"\n\n# Method 3: Set to empty string (all 146+ tools)\nexport RAILWAY_TOOLS_FILTER=\"\"\n```\n\n#### Filtering Tools\nSet the `RAILWAY_TOOLS_FILTER` environment variable to filter tools:\n\n```bash\n# For complete beginners\nexport RAILWAY_TOOLS_FILTER=\"extra-simple\"\nnpx railway-mcp\n\n# Basic users - essential operations only (42 tools)\nexport RAILWAY_TOOLS_FILTER=\"simple\"\n\n# Developers - includes creation/management (65 tools) \nexport RAILWAY_TOOLS_FILTER=\"intermediate\"\n\n# Multiple categories\nexport RAILWAY_TOOLS_FILTER=\"simple,deployment\"\n\n# Specific tools only\nexport RAILWAY_TOOLS_FILTER=\"project_list,service_create_from_repo,deployment_info\"\n\n# Mixed approach\nexport RAILWAY_TOOLS_FILTER=\"simple,backup-restore,security-audit-logs\"\n```\n\n### Available Categories\n\n#### Complexity Levels\n- **`extra-simple`** (9 tools): Absolute essentials for basic service management\n- **`simple`** (42 tools): Information, listing, and status operations\n- **`intermediate`** (65 tools): Includes simple + creation, deletion, basic management \n- **`pro`** (146+ tools): All tools including advanced workflows and enterprise features\n\n#### Use Case Categories\n- **`core`** (25 tools): Essential project, service, and deployment management\n- **`deployment`** (18 tools): Service creation and deployment operations\n- **`data`** (20 tools): Database, volume, backup, and variable management\n- **`monitoring`** (22 tools): Logs, metrics, alerts, and observability\n- **`enterprise`** (35 tools): Advanced networking, security, and compliance\n- **`team`** (12 tools): Team management, usage, and billing\n- **`integration`** (15 tools): Webhooks, templates, and external integrations\n- **`utility`** (8 tools): Configuration and helper tools\n\n### Filter Management Tools\n\nThe server includes built-in tools to help manage filtering:\n\n- **`tool_filter_current`**: Show active filter configuration\n- **`tool_filter_validate`**: Test filter strings before applying\n- **`tool_filter_examples`**: Get example configurations for different use cases \n- **`tool_filter_categories`**: List all available categories with descriptions\n\n### Configuration Examples\n\n**Claude Desktop Configuration:**\n```json\n{\n \"mcpServers\": {\n \"railway\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"railway-mcp\"],\n \"env\": {\n \"RAILWAY_API_TOKEN\": \"your-token-here\"\n // No RAILWAY_TOOLS_FILTER = all tools (default)\n // \"RAILWAY_TOOLS_FILTER\": \"intermediate,monitoring\" // Optional filtering\n }\n }\n }\n}\n```\n\n**Command Line Usage:**\n```bash\n# Default: All tools (no filtering)\nnpx railway-mcp\n\n# Test different filter configurations\nRAILWAY_TOOLS_FILTER=\"extra-simple\" npx railway-mcp\nRAILWAY_TOOLS_FILTER=\"simple\" npx railway-mcp\nRAILWAY_TOOLS_FILTER=\"deployment,data\" npx railway-mcp\n```\n\n### Best Practices\n\n- **Default is All Tools**: No configuration needed for full functionality\n- **Start Simple When Filtering**: Begin with `simple` category and add more as needed\n- **Use Case Focused**: Combine complexity with use case (e.g., `intermediate,deployment`)\n- **Validate First**: Use `tool_filter_validate` to test configurations\n- **Check Current Status**: Use `tool_filter_current` to verify active settings\n\n## Testing Framework\n\nThis MCP server includes a comprehensive testing framework that validates all functionality against real Railway infrastructure.\n\n### Quick Test\n```bash\n# Validate the complete framework\ncd test-scripts\n./quick-test.sh\n```\n\n### Complete Testing\n```bash\n# Set your Railway API token\nexport RAILWAY_API_TOKEN=\"your-railway-api-token\"\n\n# Run all tests (60-90 minutes, deploys real infrastructure)\n./master-test.sh\n\n# Run individual test phases\n./test-foundation.sh # Core functionality (5-10 min)\n./test-databases.sh # Database deployment (10-15 min) \n./test-integration.sh # Full application stack (15-20 min)\n./test-enterprise.sh # Security & compliance (10-15 min)\n```\n\n### What Gets Tested\n- โœ… **Real Deployments**: Complete application stacks with databases\n- โœ… **Enterprise Features**: Security, backup, compliance, monitoring\n- โœ… **Advanced Networking**: Private networks, load balancing, SSL\n- โœ… **DevOps Workflows**: CI/CD, rollbacks, blue-green deployments\n- โœ… **All 146+ Tools**: Every Railway API feature validated\n\nSee [MCP_TESTING_COMPLETE.md](MCP_TESTING_COMPLETE.md) for comprehensive MCP testing documentation and [TESTING_SUCCESS.md](TESTING_SUCCESS.md) for Railway infrastructure testing details.\n\n## Troubleshooting\n\nIf you encounter issues:\n\n1. **Token Authentication Issues**\n - Ensure your API token is valid and has the necessary permissions\n - If using the environment variable method, check that the token is correctly formatted in the config file\n - Try using the `configure` tool directly in Claude if the environment token isn't working\n\n2. **Server Connection Issues**\n - Check that you've installed the latest version of the server\n - Verify that Node.js version 18 or higher is installed\n - Restart Claude for Desktop after making changes to the configuration\n\n3. **API Errors**\n - Verify that you're using correct project, environment, and service IDs\n - Check Railway's status page for any service disruptions\n - Railway API has rate limits - avoid making too many requests in a short period\n\n## Contributing\n\nWe welcome contributions from the community! Please see our [Contributing Guidelines](CONTRIBUTING.md) for details on how to get started, development guidelines, and debugging information.\n\n\n\n\n\n## ๐Ÿ› ๏ธ **Available Tools (146+ Total)**\n\n
\n๐Ÿ—๏ธ Core Infrastructure (25 tools)\n\n### **Authentication & Configuration**\n- `configure_api_token` - Configure Railway API authentication\n- `config-*` - Project and service configuration management\n\n### **Project Management**\n- `project_list` - List all projects in your account\n- `project_info` - Get detailed project information \n- `project_create` - Create new projects with team support\n- `project_delete` - Delete projects and all resources\n- `project_environments` - Manage project environments\n\n### **Service Deployment**\n- `service_list` - List all services in a project\n- `service_info` - Get detailed service information\n- `service_create_from_repo` - Deploy from GitHub repositories\n- `service_create_from_image` - Deploy from Docker images\n- `service_delete` - Remove services\n- `service_restart` - Restart services\n- `service_update` - Update service configurations\n\n### **Environment Management**\n- `environment-create` - Create new environments\n- `environment-list` - List all environments\n- `environment-delete` - Remove environments\n- `environment-clone` - Clone environments with variables\n- `environment-deploy` - Deploy all services in environment\n\n
\n\n
\n๐Ÿ—„๏ธ Database & Storage (18 tools)\n\n### **Database Management**\n- `database_list_types` - List available database types (PostgreSQL, MySQL, Redis, MongoDB)\n- `database_deploy_from_template` - Deploy configured databases\n- Database configuration and connection management\n\n### **Volume & Storage**\n- `volume_create` - Create persistent volumes\n- `volume_list` - List project volumes\n- `volume_delete` - Remove volumes\n- `volume_attach` - Attach volumes to services\n\n### **Configuration Management**\n- `variable_list` - List service/environment variables\n- `variable_set` - Create or update variables\n- `variable_delete` - Remove variables\n- `variable_bulk_set` - Bulk variable operations\n- `variable_copy` - Copy variables between environments\n\n
\n\n
\n๐Ÿ›ก๏ธ Enterprise Security (15 tools)\n\n### **Backup & Recovery**\n- `backup-list` - List project backups\n- `backup-create` - Create manual backups\n- `backup-get` - Get backup details\n- `backup-restore` - Restore from backups\n- `backup-delete` - Remove backups\n- `backup-policy-*` - Automated backup policies\n\n### **Security & Compliance**\n- `security-audit-logs` - Security audit trail\n- `security-vulnerabilities` - Vulnerability scanning\n- `security-access-tokens` - Access token management\n- `security-ip-allowlist` - IP access control\n- `security-compliance-report` - SOC2, GDPR, HIPAA, PCI-DSS reporting\n\n
\n\n
\n๐Ÿ“Š Monitoring & Observability (20 tools)\n\n### **Performance Monitoring**\n- `monitoring-metrics-list` - Custom metrics tracking\n- `monitoring-apm-data` - Application performance monitoring\n- `monitoring-performance-data` - Performance analytics\n- `monitoring-traces` - Distributed tracing\n\n### **Alerting & Notifications**\n- `monitoring-alerts-*` - Multi-channel alerting (email, Slack, webhook)\n- `monitoring-notifications-*` - Notification management\n\n### **Logging**\n- `logs-service` - Runtime logs\n- `logs-build` - Build logs\n- `logs-deployment` - Deployment logs\n\n
\n\n
\n๐ŸŒ Networking & Infrastructure (30 tools)\n\n### **Domain Management**\n- `domain_create` - Create service domains\n- `domain_list` - List service domains\n- `domain_update` - Update domain configuration\n- `domain_delete` - Remove domains\n- `custom-domain-*` - Custom domain management with SSL\n\n### **Private Networking**\n- `networking-private-*` - Private network creation and management\n- `networking-security-groups` - Network security groups\n- `networking-firewall-rules` - Firewall configuration\n\n### **Load Balancing**\n- `networking-loadbalancer-*` - Load balancer setup and management\n- Health checks and traffic distribution\n\n### **TCP/UDP Proxying**\n- `tcp_proxy_create` - Create TCP proxies\n- `tcp_proxy_list` - List TCP proxies\n- Direct database and service connections\n\n
\n\n
\n๐Ÿ”— DevOps & CI/CD (13 tools)\n\n### **GitHub Integration**\n- `github-repo-list` - List accessible repositories\n- `github-repo-check` - Verify repository access\n- `github-branch-list` - List repository branches\n- `github-repo-deploy` - Deploy from GitHub\n- `github-repo-link` - Link repositories to services\n\n### **Deployment Strategies**\n- `deployment_list` - List deployments\n- `deployment_trigger` - Trigger deployments\n- `deployment_logs` - Deployment logs\n- `deployment_status` - Deployment status\n- Advanced deployment strategies (blue-green, canary)\n\n
\n\n
\nโš™๏ธ Templates & Advanced (8 tools)\n\n### **Template System**\n- `template-list` - List available templates\n- `template-deploy` - Deploy from templates\n- Pre-configured stacks and best practices\n\n### **Resource Management**\n- `resource-list` - List project resources\n- `usage-get` - Resource usage analytics\n- `team-*` - Team and collaboration tools\n\n
\n\n## ๐Ÿ’ป **MCP Client Examples**\n\n
\n๐Ÿ–ฅ๏ธ Claude Desktop Usage\n\nAfter installing via Smithery or manual configuration, you can use natural language to manage Railway infrastructure:\n\n```\n# Project Management\n\"List all my Railway projects\"\n\"Create a new project called 'my-startup-app'\"\n\"Show me details for project abc123\"\n\n# Full-Stack Deployment\n\"Deploy a Next.js app from my GitHub repo 'username/my-app'\"\n\"Add a PostgreSQL database to this project\"\n\"Set the DATABASE_URL environment variable for my service\"\n\"Create a custom domain for my app\"\n\n# Monitoring & Maintenance\n\"Show me the logs for my service deployment\"\n\"Create a backup of my database\"\n\"Set up daily automated backups\"\n\"Generate a security audit report\"\n```\n\nClaude Desktop excels at orchestrating complex workflows and providing detailed explanations of Railway operations.\n\n
\n\n
\nโšก Claude Code (CLI) Usage\n\nClaude Code provides powerful terminal integration for development workflows:\n\n```bash\n# In your terminal with Claude Code\nclaude \"List my Railway projects and deploy the latest version of my app\"\n\n# Development workflow\nclaude \"Create a staging environment, deploy my current branch, and run tests\"\n\n# Infrastructure management\nclaude \"Scale up my database, check performance metrics, and optimize if needed\"\n\n# Emergency response\nclaude \"My app is down - check logs, identify issues, and redeploy if necessary\"\n```\n\nClaude Code is ideal for development workflows, CI/CD automation, and rapid infrastructure management during development.\n\n
\n\n
\n๐ŸŽฏ Cursor IDE Integration\n\nCursor provides seamless code-to-deployment workflows:\n\n```typescript\n// While coding in Cursor, use natural language:\n\n\"Push my changes to GitHub and deploy to Railway staging environment\"\n\n\"This API needs a Redis cache - add Redis to Railway and update my environment variables\"\n\n\"Create a production environment with the same services as staging\"\n\n\"Set up monitoring alerts for this new API endpoint\"\n\n// Cursor + Railway MCP workflow:\n// 1. Code changes in Cursor\n// 2. Cursor commits and pushes to GitHub \n// 3. Railway MCP deploys automatically\n// 4. Monitor and manage through natural language\n```\n\nCursor excels at connecting your development environment directly to Railway infrastructure with Git integration.\n\n
\n\n## ๐Ÿš€ **Example Workflows**\n\n
\n๐Ÿ—๏ธ Deploy Complete Full-Stack Application\n\n```bash\n# 1. Create project and deploy services\n\"Create a new Railway project called 'my-app'\"\n\"Deploy a Next.js service from my GitHub repo\"\n\"Add a PostgreSQL database\"\n\"Add a Redis cache\"\n\n# 2. Configure environment variables\n\"Set DATABASE_URL for the Next.js service\"\n\"Set REDIS_URL for session storage\"\n\"Add JWT_SECRET for authentication\"\n\n# 3. Set up custom domain\n\"Create a custom domain for the app\"\n\"Configure SSL certificate\"\n```\n\n
\n\n
\n๐Ÿ›ก๏ธ Enterprise Security Setup\n\n```bash\n# 1. Enable backup policies\n\"Create daily backup policy for the database\"\n\"Set backup retention to 30 days\"\n\n# 2. Configure security\n\"Set up IP allowlist for database access\"\n\"Enable vulnerability scanning\"\n\"Generate security audit report\"\n\n# 3. Compliance reporting\n\"Generate SOC2 compliance report\"\n\"Set up GDPR data protection policies\"\n```\n\n
\n\n
\n๐Ÿ“Š Monitoring & Observability\n\n```bash\n# 1. Set up monitoring\n\"Create custom metrics for response time\"\n\"Set up alerts for high CPU usage\"\n\"Configure Slack notifications\"\n\n# 2. Performance tracking\n\"Enable distributed tracing\"\n\"Set up APM monitoring\"\n\"Create performance dashboard\"\n```\n\n
\n\n
\n๐ŸŒ Advanced Networking\n\n```bash\n# 1. Private networking\n\"Create private network for database access\"\n\"Set up load balancer for high availability\"\n\"Configure security groups\"\n\n# 2. Domain management\n\"Add custom domain with SSL\"\n\"Set up TCP proxy for direct database access\"\n\"Configure firewall rules\"\n```\n\n
\n\n
\n๐Ÿ”„ DevOps & CI/CD\n\n```bash\n# 1. GitHub integration\n\"Link GitHub repository to service\"\n\"Set up automatic deployments on push\"\n\"Configure deployment branches\"\n\n# 2. Deployment strategies\n\"Set up blue-green deployment\"\n\"Create staging environment\"\n\"Configure rollback policies\"\n```\n\n
","readmeFilename":"README.md"}