Track Deployments Across Platforms
A universal MCP deployment tracker across Vercel/Netlify/Cloudflare Pages - status, logs, real-time monitoring, and live shields.io badges.
Why it matters
Monitor and track deployments across Vercel, Netlify, and Cloudflare Pages directly within AI conversations. Get real-time status updates and deployment badges for your projects.
Outcomes
What it gets done
Monitor Vercel, Netlify, and Cloudflare Pages deployments.
Receive real-time status updates and notifications.
Generate deployment badges for README files.
Access deployment history and logs.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-deploy-mcp | bash Capabilities
Tools your agent gets
Get the latest deployment status or history
Monitor deployment in real-time
Compare recent deployments
Get deployment logs
List all available projects
Overview
deploy-mcp MCP Server
A universal MCP deployment tracker for Vercel, Netlify, and Cloudflare Pages - status, real-time monitoring, comparison, logs, and project listing, plus live shields.io status badges. Use when an AI assistant needs to check, monitor, or compare deployments across Vercel, Netlify, or Cloudflare Pages without leaving the conversation.
What it does
Tracks deployments across multiple hosting platforms directly inside an AI conversation, removing the need to context-switch to each platform's own dashboard. Vercel, Netlify, and Cloudflare Pages are fully supported today, with GitHub Pages planned, each configured with its own API token, and multiple platforms can be configured simultaneously in the same server instance. Five core tools cover the whole workflow: check_deployment_status for the latest status or a deployment history, watch_deployment for real-time monitoring of an in-progress deploy, compare_deployments to diff recent deployments against each other, get_deployment_logs to fetch logs for a specific deployment, and list_projects to discover all projects or sites available on a platform. The AI picks the right platform automatically from an explicit mention in the command, a matching project or site name, or whichever tokens happen to be configured.
Beyond the MCP server itself, deploy-mcp.io provides live deployment status badges compatible with shields.io's endpoint format, embeddable per platform in a repository README, with webhook configuration available on Vercel (Pro/Enterprise) and Netlify for real-time badge updates rather than polling - badges currently require public repositories, with private repo support planned. Security is scoped deliberately: API tokens stay local to the machine running the server, there is no telemetry or usage tracking, the codebase is fully open source and auditable, and only read-level permissions are ever required from any connected platform.
When to use - and when NOT to
Use it when an AI assistant needs to check, monitor, or compare deployments across Vercel, Netlify, or Cloudflare Pages without leaving the conversation. Getting started takes under 30 seconds with npx deploy-mcp, and it works with any MCP-compatible client - Claude Desktop, VS Code behind a GitHub Copilot subscription with MCP enabled, Cursor, Windsurf, Continue.dev with a distinct nested config structure, and Cline, each documented with its own config file location. Each platform's token has a specific source and permission scope: Vercel needs a token from its account tokens page with deployment and project read access, Netlify needs a personal access token with site and deploy read access, and Cloudflare Pages accepts either a scoped custom API token or a combined accountId-and-globalApiKey format.
Capabilities
Deployment status, real-time monitoring, deployment comparison, log retrieval, and project or site listing across Vercel, Netlify, and Cloudflare Pages simultaneously, plus externally hosted, webhook-updatable status badges.
How to install
Run npx deploy-mcp to start immediately, or install globally with npm install -g deploy-mcp for production use; configure per-platform tokens either as environment variables or directly in the MCP client's config:
{
"mcpServers": {
"deploy-mcp": {
"command": "npx",
"args": ["-y", "deploy-mcp"],
"env": {
"VERCEL_TOKEN": "your-vercel-token",
"NETLIFY_TOKEN": "your-netlify-token",
"CLOUDFLARE_TOKEN": "accountId:globalApiKey"
}
}
}
}
Who it's for
Developers deploying to Vercel, Netlify, or Cloudflare Pages who want deployment status, logs, and monitoring available directly in their AI assistant instead of switching to each platform's own dashboard. The project is licensed under Apache 2.0.
Source README
deploy-mcp
Universal Deployment Tracker for AI Assistants
Track deployments across all platforms directly in your AI conversation.
No more context-switching. No more dashboard hunting.
Demo
Quick Start
─────────────────────────
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.
Supported Platforms
─────────────────────────
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 |
| Cloudflare Pages | ✅ Ready | CLOUDFLARE_TOKEN |
Status, Logs, History, Real-time Monitoring |
| GitHub Pages | 🚧 Coming Soon | GITHUB_TOKEN |
- |
Multi-Platform Configuration
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",
"CLOUDFLARE_TOKEN": "accountId:globalApiKey"
// Add more platform tokens as needed
}
}
}
}
Platform Configuration
─────────────────────────
Vercel
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
Netlify
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
Cloudflare Pages
Setup Instructions
Get your API token:
- Go to dash.cloudflare.com/profile/api-tokens
- Click "Create Token"
- Use "Custom token" with these permissions:
- Zone:Zone:Read
- Zone:Page Rules:Read
- Account:Cloudflare Pages:Edit
- Or use your Global API Key (format:
accountId:globalApiKey) - Copy the token
Add to your AI assistant configuration:
{ "env": { "CLOUDFLARE_TOKEN": "your-cloudflare-token-or-accountId:globalApiKey" } }Available commands:
"Check my Cloudflare Pages deployment for project-name""What's the status of my latest Cloudflare Pages deployment?""Show me Cloudflare Pages deployment logs""Watch my Cloudflare Pages deployment progress""List all my Cloudflare Pages projects""Show deployment history for project-name"
Token formats supported:
- API Token:
your-api-token(requiresCLOUDFLARE_ACCOUNT_IDenv var) - Global API Key:
accountId:globalApiKey(all-in-one format)
- API Token:
Required permissions: Account access to Cloudflare Pages
AI Assistant Configuration
─────────────────────────
deploy-mcp works with any MCP-compatible AI assistant. Here's how to set it up:
Claude Desktop
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"
}
}
}
}
VS Code
Configuration
File location:
- Workspace:
.vscode/mcp.json - Global:
~/.vscode/mcp.json
Requirements: GitHub Copilot subscription with MCP enabled
Configuration: Same as Claude Desktop
Cursor AI
Configuration
File location: ~/.cursor/mcp.json
Setup: Navigate to Cursor Settings → MCP
Configuration: Same as Claude Desktop
Windsurf IDE
Configuration
File location: ~/.codeium/windsurf/mcp_config.json
Setup: Settings → Advanced Settings → Cascade
Configuration: Same as Claude Desktop
Continue.dev
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"
}
}
}
}
Cline (VS Code Extension)
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
Deployment Status Badges
─────────────────────────
Get live deployment status badges for your repositories:
Badge Format
The deploy-mcp.io endpoint returns JSON data for shields.io. Use the shields.io endpoint wrapper:

Examples by Platform
Vercel Badge

Netlify Badge

Multiple Badges


Webhook Configuration
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.
Available Tools
─────────────────────────
deploy-mcp provides these tools to your AI assistant:
Core Tools
| 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" |
Platform-Specific Usage
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"
New Features
List Projects
Discover all your projects/sites across platforms:
"List my Vercel projects"
"Show all Netlify sites"
"What projects do I have on Vercel?"
Deployment History
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
Security
─────────────────────────
- 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
Advanced Configuration
─────────────────────────
Environment Variables
You can also set tokens via environment variables:
export VERCEL_TOKEN="your-vercel-token"
export NETLIFY_TOKEN="your-netlify-token"
npx deploy-mcp
Custom Installation
For production use, install globally:
npm install -g deploy-mcp
deploy-mcp
Links
─────────────────────────
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.