Universal Deployment Tracker for AI Assistants
Track deployments across all platforms directly in your AI conversation.
No more context-switching. No more dashboard hunting.
─────────────────────────
Get started in under 30 seconds:
npx deploy-mcp
That's it! The server is now running and ready to be configured in your AI assistant.
─────────────────────────
deploy-mcp supports multiple deployment platforms simultaneously. Configure as many as you need:
Platform | Status | Token Required | Features |
---|---|---|---|
Vercel | ✅ Ready | VERCEL_TOKEN |
Status, Logs, History, Real-time Monitoring |
Netlify | ✅ Ready | NETLIFY_TOKEN |
Status, Logs, History, Real-time Monitoring |
Railway | Coming Soon | RAILWAY_TOKEN |
- |
Render | Coming Soon | RENDER_TOKEN |
- |
You can use multiple platforms simultaneously by providing tokens for each platform you want to track:
{
"mcpServers": {
"deploy-mcp": {
"command": "npx",
"args": ["-y", "deploy-mcp"],
"env": {
"VERCEL_TOKEN": "your-vercel-token",
"NETLIFY_TOKEN": "your-netlify-token"
// Add more platform tokens as needed
}
}
}
}
─────────────────────────
Setup Instructions
-
Get your API token:
- Go to vercel.com/account/tokens
- Click "Create Token"
- Give it a descriptive name (e.g., "deploy-mcp")
- Copy the token
-
Add to your AI assistant configuration:
{ "env": { "VERCEL_TOKEN": "your-vercel-token" } }
-
Available commands:
"Check my Vercel deployment for project-name"
"What's the status of my latest Vercel deployment?"
"Show me Vercel deployment logs"
"Watch my Vercel deployment progress"
"List all my Vercel projects"
"Show last 5 deployments for project-name"
-
Required permissions: Read access to deployments and projects
Setup Instructions
-
Get your API token:
- Go to app.netlify.com/user/applications
- Under "Personal access tokens", click "New access token"
- Give it a descriptive name (e.g., "deploy-mcp")
- Copy the token
-
Add to your AI assistant configuration:
{ "env": { "NETLIFY_TOKEN": "your-netlify-token" } }
-
Available commands:
"Check my Netlify deployment for site-name"
"What's the status of my latest Netlify deployment?"
"Show me Netlify deployment logs"
"Watch my Netlify deployment progress"
"List all my Netlify sites"
"Show deployment history for site-name"
-
Required permissions: Read access to sites and deploys
─────────────────────────
deploy-mcp works with any MCP-compatible AI assistant. Here's how to set it up:
Configuration
File location:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
- Linux:
~/.config/Claude/claude_desktop_config.json
Configuration:
{
"mcpServers": {
"deploy-mcp": {
"command": "npx",
"args": ["-y", "deploy-mcp"],
"env": {
"VERCEL_TOKEN": "your-vercel-token",
"NETLIFY_TOKEN": "your-netlify-token"
}
}
}
}
Configuration
File location:
- Workspace:
.vscode/mcp.json
- Global:
~/.vscode/mcp.json
Requirements: GitHub Copilot subscription with MCP enabled
Configuration: Same as Claude Desktop
Configuration
File location: ~/.cursor/mcp.json
Setup: Navigate to Cursor Settings → MCP
Configuration: Same as Claude Desktop
Configuration
File location: ~/.codeium/windsurf/mcp_config.json
Setup: Settings → Advanced Settings → Cascade
Configuration: Same as Claude Desktop
Configuration
File location: ~/.continue/config.json
Configuration (different structure):
{
"experimental": {
"modelContextProtocolServer": {
"transport": {
"type": "stdio",
"command": "npx",
"args": ["-y", "deploy-mcp"]
},
"env": {
"VERCEL_TOKEN": "your-vercel-token",
"NETLIFY_TOKEN": "your-netlify-token"
}
}
}
}
Configuration
Natural language setup:
- Ask: "Add the deploy-mcp tool to check deployments"
Manual setup:
- MCP Servers icon → Advanced MCP Settings
Configuration: Same as Claude Desktop
─────────────────────────
Get live deployment status badges for your repositories:
The deploy-mcp.io endpoint returns JSON data for shields.io. Use the shields.io endpoint wrapper:





For real-time badge updates, configure webhooks:
Vercel Webhooks (Pro/Enterprise only)
- Go to your Vercel team settings
- Navigate to "Webhooks" section
- Click "Create Webhook"
- Configure:
- URL:
https://deploy-mcp.io/webhook/{username}/{repo}/vercel
- Events: Deployment Created, Ready, Error
- Projects: Select specific or all
- URL:
Netlify Webhooks
- Go to Site Settings → Build & deploy → Deploy notifications
- Add notification → Outgoing webhook
- Configure:
- URL:
https://deploy-mcp.io/webhook/{username}/{repo}/netlify
- Events: Deploy started, succeeded, failed
- URL:
Note: Badges require public repositories. Private repo support coming soon.
─────────────────────────
deploy-mcp provides these tools to your AI assistant:
Tool | Description | Example Command |
---|---|---|
check_deployment_status |
Get latest deployment status or history | "Check my deployment status" / "Show last 5 deployments" |
watch_deployment |
Monitor deployment in real-time | "Watch my deployment progress" |
compare_deployments |
Compare recent deployments | "Compare my last 2 deployments" |
get_deployment_logs |
Fetch deployment logs | "Show me deployment logs" |
list_projects |
List all available projects | "List my Vercel projects" / "Show all Netlify sites" |
Commands work across all configured platforms:
"Check my Vercel deployment for my-app"
"Show last 10 deployments for my-app on Vercel"
"List all my Vercel projects"
"Check my Netlify deployment for my-site"
"Show me logs for deployment abc123 on Vercel"
"Watch my Netlify deployment progress"
"Show all my Netlify sites"
Discover all your projects/sites across platforms:
"List my Vercel projects"
"Show all Netlify sites"
"What projects do I have on Vercel?"
View multiple recent deployments at once:
"Show last 5 deployments for my-app"
"Get deployment history for my-site"
"Check last 10 deployments on Vercel"
The AI will automatically use the correct platform based on:
- Explicit platform mention in your command
- Project/site name matching
- Available tokens in configuration
─────────────────────────
- Local tokens only - Your API tokens stay on your machine
- No telemetry - We don't track usage or collect data
- Open source - Fully auditable codebase
- Minimal permissions - Only read access required
─────────────────────────
You can also set tokens via environment variables:
export VERCEL_TOKEN="your-vercel-token"
export NETLIFY_TOKEN="your-netlify-token"
npx deploy-mcp
For production use, install globally:
npm install -g deploy-mcp
deploy-mcp
─────────────────────────
We welcome contributions! See CONTRIBUTING.md for guidelines.
- Implement the
BaseAdapter
interface - Add platform-specific API client
- Update configuration documentation
- Add tests
─────────────────────────
Apache 2.0 - See LICENSE for details.
─────────────────────────