Universal Deployment Tracker for AI Assistants Track deployments across all platforms directly in your AI conversation. No more context-switching. No more dashboard hunting. Watch Full Demo · Live Badge Demo ───────────────────────── Get started in under 30 seconds: That's it! The server is now running and ready to be configured in your AI assistant. ───────────────────────── deploy-mcp supports m
Add this skill
npx mdskills install alexpota/deploy-mcpWell-documented MCP server for multi-platform deployment tracking with clear setup instructions and useful tools
1<div align="center">23# deploy-mcp45**Universal Deployment Tracker for AI Assistants**67Track deployments across all platforms directly in your AI conversation.8No more context-switching. No more dashboard hunting.910[](https://www.npmjs.com/package/deploy-mcp)11[](https://www.npmjs.com/package/deploy-mcp)12[](https://github.com/alexpota/deploy-mcp/blob/main/LICENSE)13[](https://deploy-mcp.io)1415</div>1617---1819## Demo2021<div align="center">2223 <kbd>24 <a href="./assets/demo.gif">25 <img src="./assets/demo-preview.png" alt="Click to watch full demo" width="600" />26 </a>27 </kbd>2829 <br /><br />3031 <sub>**[Watch Full Demo](./assets/demo.gif)** · **[Live Badge Demo](https://mcp-netlify-demo.netlify.app/)**</sub>3233</div>3435---3637## Quick Start38─────────────────────────3940**Get started in under 30 seconds:**4142```bash43npx deploy-mcp44```4546That's it! The server is now running and ready to be configured in your AI assistant.4748## Supported Platforms49─────────────────────────5051deploy-mcp supports multiple deployment platforms simultaneously. Configure as many as you need:5253| Platform | Status | Token Required | Features |54|----------|--------|---------------|----------|55| **Vercel** | ✅ Ready | `VERCEL_TOKEN` | Status, Logs, History, Real-time Monitoring |56| **Netlify** | ✅ Ready | `NETLIFY_TOKEN` | Status, Logs, History, Real-time Monitoring |57| **Cloudflare Pages** | ✅ Ready | `CLOUDFLARE_TOKEN` | Status, Logs, History, Real-time Monitoring |58| **GitHub Pages** | 🚧 Coming Soon | `GITHUB_TOKEN` | - |5960### Multi-Platform Configuration6162You can use **multiple platforms simultaneously** by providing tokens for each platform you want to track:6364```json65{66 "mcpServers": {67 "deploy-mcp": {68 "command": "npx",69 "args": ["-y", "deploy-mcp"],70 "env": {71 "VERCEL_TOKEN": "your-vercel-token",72 "NETLIFY_TOKEN": "your-netlify-token",73 "CLOUDFLARE_TOKEN": "accountId:globalApiKey"74 // Add more platform tokens as needed75 }76 }77 }78}79```8081## Platform Configuration82─────────────────────────8384### Vercel8586<details>87<summary><strong>Setup Instructions</strong></summary>88891. **Get your API token:**90 - Go to [vercel.com/account/tokens](https://vercel.com/account/tokens)91 - Click "Create Token"92 - Give it a descriptive name (e.g., "deploy-mcp")93 - Copy the token94952. **Add to your AI assistant configuration:**96 ```json97 {98 "env": {99 "VERCEL_TOKEN": "your-vercel-token"100 }101 }102 ```1031043. **Available commands:**105 - `"Check my Vercel deployment for project-name"`106 - `"What's the status of my latest Vercel deployment?"`107 - `"Show me Vercel deployment logs"`108 - `"Watch my Vercel deployment progress"`109 - `"List all my Vercel projects"`110 - `"Show last 5 deployments for project-name"`1111124. **Required permissions:** Read access to deployments and projects113114</details>115116### Netlify117118<details>119<summary><strong>Setup Instructions</strong></summary>1201211. **Get your API token:**122 - Go to [app.netlify.com/user/applications](https://app.netlify.com/user/applications)123 - Under "Personal access tokens", click "New access token"124 - Give it a descriptive name (e.g., "deploy-mcp")125 - Copy the token1261272. **Add to your AI assistant configuration:**128 ```json129 {130 "env": {131 "NETLIFY_TOKEN": "your-netlify-token"132 }133 }134 ```1351363. **Available commands:**137 - `"Check my Netlify deployment for site-name"`138 - `"What's the status of my latest Netlify deployment?"`139 - `"Show me Netlify deployment logs"`140 - `"Watch my Netlify deployment progress"`141 - `"List all my Netlify sites"`142 - `"Show deployment history for site-name"`1431444. **Required permissions:** Read access to sites and deploys145146</details>147148### Cloudflare Pages149150<details>151<summary><strong>Setup Instructions</strong></summary>1521531. **Get your API token:**154 - Go to [dash.cloudflare.com/profile/api-tokens](https://dash.cloudflare.com/profile/api-tokens)155 - Click "Create Token"156 - Use "Custom token" with these permissions:157 - **Zone:Zone:Read**158 - **Zone:Page Rules:Read**159 - **Account:Cloudflare Pages:Edit**160 - Or use your Global API Key (format: `accountId:globalApiKey`)161 - Copy the token1621632. **Add to your AI assistant configuration:**164 ```json165 {166 "env": {167 "CLOUDFLARE_TOKEN": "your-cloudflare-token-or-accountId:globalApiKey"168 }169 }170 ```1711723. **Available commands:**173 - `"Check my Cloudflare Pages deployment for project-name"`174 - `"What's the status of my latest Cloudflare Pages deployment?"`175 - `"Show me Cloudflare Pages deployment logs"`176 - `"Watch my Cloudflare Pages deployment progress"`177 - `"List all my Cloudflare Pages projects"`178 - `"Show deployment history for project-name"`1791804. **Token formats supported:**181 - **API Token**: `your-api-token` (requires `CLOUDFLARE_ACCOUNT_ID` env var)182 - **Global API Key**: `accountId:globalApiKey` (all-in-one format)1831845. **Required permissions:** Account access to Cloudflare Pages185186</details>187188## AI Assistant Configuration189─────────────────────────190191deploy-mcp works with any MCP-compatible AI assistant. Here's how to set it up:192193### Claude Desktop194195<details>196<summary><strong>Configuration</strong></summary>197198**File location:**199- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`200- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`201- **Linux**: `~/.config/Claude/claude_desktop_config.json`202203**Configuration:**204```json205{206 "mcpServers": {207 "deploy-mcp": {208 "command": "npx",209 "args": ["-y", "deploy-mcp"],210 "env": {211 "VERCEL_TOKEN": "your-vercel-token",212 "NETLIFY_TOKEN": "your-netlify-token"213 }214 }215 }216}217```218219</details>220221### VS Code222223<details>224<summary><strong>Configuration</strong></summary>225226**File location:**227- Workspace: `.vscode/mcp.json`228- Global: `~/.vscode/mcp.json`229230**Requirements:** GitHub Copilot subscription with MCP enabled231232**Configuration:** Same as Claude Desktop233234</details>235236### Cursor AI237238<details>239<summary><strong>Configuration</strong></summary>240241**File location:** `~/.cursor/mcp.json`242243**Setup:** Navigate to Cursor Settings → MCP244245**Configuration:** Same as Claude Desktop246247</details>248249### Windsurf IDE250251<details>252<summary><strong>Configuration</strong></summary>253254**File location:** `~/.codeium/windsurf/mcp_config.json`255256**Setup:** Settings → Advanced Settings → Cascade257258**Configuration:** Same as Claude Desktop259260</details>261262### Continue.dev263264<details>265<summary><strong>Configuration</strong></summary>266267**File location:** `~/.continue/config.json`268269**Configuration (different structure):**270```json271{272 "experimental": {273 "modelContextProtocolServer": {274 "transport": {275 "type": "stdio",276 "command": "npx",277 "args": ["-y", "deploy-mcp"]278 },279 "env": {280 "VERCEL_TOKEN": "your-vercel-token",281 "NETLIFY_TOKEN": "your-netlify-token"282 }283 }284 }285}286```287288</details>289290### Cline (VS Code Extension)291292<details>293<summary><strong>Configuration</strong></summary>294295**Natural language setup:**296- Ask: *"Add the deploy-mcp tool to check deployments"*297298**Manual setup:**299- MCP Servers icon → Advanced MCP Settings300301**Configuration:** Same as Claude Desktop302303</details>304305## Deployment Status Badges306─────────────────────────307308Get live deployment status badges for your repositories:309310### Badge Format311312The deploy-mcp.io endpoint returns JSON data for shields.io. Use the shields.io endpoint wrapper:313314```markdown315316```317318### Examples by Platform319320#### Vercel Badge321```markdown322323```324325#### Netlify Badge326```markdown327328```329330#### Multiple Badges331```markdown332333334```335336### Webhook Configuration337338For real-time badge updates, configure webhooks:339340<details>341<summary><strong>Vercel Webhooks</strong> (Pro/Enterprise only)</summary>3423431. Go to your Vercel team settings3442. Navigate to "Webhooks" section3453. Click "Create Webhook"3464. Configure:347 - **URL**: `https://deploy-mcp.io/webhook/{username}/{repo}/vercel`348 - **Events**: Deployment Created, Ready, Error349 - **Projects**: Select specific or all350351</details>352353<details>354<summary><strong>Netlify Webhooks</strong></summary>3553561. Go to Site Settings → Build & deploy → Deploy notifications3572. Add notification → Outgoing webhook3583. Configure:359 - **URL**: `https://deploy-mcp.io/webhook/{username}/{repo}/netlify`360 - **Events**: Deploy started, succeeded, failed361362</details>363364**Note:** Badges require public repositories. Private repo support coming soon.365366## Available Tools367─────────────────────────368369deploy-mcp provides these tools to your AI assistant:370371### Core Tools372373| Tool | Description | Example Command |374|------|-------------|-----------------|375| `check_deployment_status` | Get latest deployment status or history | *"Check my deployment status"* / *"Show last 5 deployments"* |376| `watch_deployment` | Monitor deployment in real-time | *"Watch my deployment progress"* |377| `compare_deployments` | Compare recent deployments | *"Compare my last 2 deployments"* |378| `get_deployment_logs` | Fetch deployment logs | *"Show me deployment logs"* |379| `list_projects` | List all available projects | *"List my Vercel projects"* / *"Show all Netlify sites"* |380381### Platform-Specific Usage382383Commands work across all configured platforms:384385```386"Check my Vercel deployment for my-app"387"Show last 10 deployments for my-app on Vercel"388"List all my Vercel projects"389"Check my Netlify deployment for my-site"390"Show me logs for deployment abc123 on Vercel"391"Watch my Netlify deployment progress"392"Show all my Netlify sites"393```394395### New Features396397#### List Projects398Discover all your projects/sites across platforms:399```400"List my Vercel projects"401"Show all Netlify sites"402"What projects do I have on Vercel?"403```404405#### Deployment History406View multiple recent deployments at once:407```408"Show last 5 deployments for my-app"409"Get deployment history for my-site"410"Check last 10 deployments on Vercel"411```412413The AI will automatically use the correct platform based on:4141. Explicit platform mention in your command4152. Project/site name matching4163. Available tokens in configuration417418## Security419─────────────────────────420421- **Local tokens only** - Your API tokens stay on your machine422- **No telemetry** - We don't track usage or collect data423- **Open source** - Fully auditable codebase424- **Minimal permissions** - Only read access required425426## Advanced Configuration427─────────────────────────428429### Environment Variables430431You can also set tokens via environment variables:432433```bash434export VERCEL_TOKEN="your-vercel-token"435export NETLIFY_TOKEN="your-netlify-token"436npx deploy-mcp437```438439### Custom Installation440441For production use, install globally:442443```bash444npm install -g deploy-mcp445deploy-mcp446```447448## Contributing449─────────────────────────450451We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.452453### Adding New Platforms4544551. Implement the `BaseAdapter` interface4562. Add platform-specific API client4573. Update configuration documentation4584. Add tests459460## License461─────────────────────────462463Apache 2.0 - See [LICENSE](LICENSE) for details.464465## Links466─────────────────────────467468- [Website](https://deploy-mcp.io)469- [npm Package](https://www.npmjs.com/package/deploy-mcp)470- [GitHub Repository](https://github.com/alexpota/deploy-mcp)471- [Report Issues](https://github.com/alexpota/deploy-mcp/issues)472473---474475<div align="center">476Made with ❤️ for developers who love AI-assisted coding477</div>
Full transparency — inspect the skill content before installing.