# 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. [![npm version](https://img.shields.io/npm/v/deploy-mcp.svg?style=for-the-badge&color=ff6b6b)](https://www.npmjs.com/package/deploy-mcp) [![npm downloads](https://img.shields.io/npm/dm/deploy-mcp.svg?style=for-the-badge&color=00d2d3)](https://www.npmjs.com/package/deploy-mcp) [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg?style=for-the-badge)](https://github.com/alexpota/deploy-mcp/blob/main/LICENSE) [![Website](https://img.shields.io/badge/website-deploy--mcp.io-ff8e53?style=for-the-badge)](https://deploy-mcp.io)

Demo

_{**[Watch Full Demo](./assets/demo.gif)** · **[Live Badge Demo](https://mcp-netlify-demo.netlify.app/)**}

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

1. **Get your API token:** - Go to [vercel.com/account/tokens](https://vercel.com/account/tokens) - Click "Create Token" - Give it a descriptive name (e.g., "deploy-mcp") - Copy the token 2. **Add to your AI assistant configuration:** ```json { "env": { "VERCEL_TOKEN": "your-vercel-token" } } ``` 3. **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"` 4. **Required permissions:** Read access to deployments and projects

Netlify

Setup Instructions

1. **Get your API token:** - Go to [app.netlify.com/user/applications](https://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 2. **Add to your AI assistant configuration:** ```json { "env": { "NETLIFY_TOKEN": "your-netlify-token" } } ``` 3. **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"` 4. **Required permissions:** Read access to sites and deploys

Cloudflare Pages

Setup Instructions

1. **Get your API token:** - Go to [dash.cloudflare.com/profile/api-tokens](https://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 2. **Add to your AI assistant configuration:** ```json { "env": { "CLOUDFLARE_TOKEN": "your-cloudflare-token-or-accountId:globalApiKey" } } ``` 3. **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"` 4. **Token formats supported:** - **API Token**: `your-api-token` (requires `CLOUDFLARE_ACCOUNT_ID` env var) - **Global API Key**: `accountId:globalApiKey` (all-in-one format) 5. **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:

![Platform Deployment](https://img.shields.io/endpoint?url=https://deploy-mcp.io/badge/{username}/{repository}/{platform})

Examples by Platform

Vercel Badge

![Vercel](https://img.shields.io/endpoint?url=https://deploy-mcp.io/badge/john/my-app/vercel)

Netlify Badge

![Netlify](https://img.shields.io/endpoint?url=https://deploy-mcp.io/badge/john/my-app/netlify)

Multiple Badges

![Vercel](https://img.shields.io/endpoint?url=https://deploy-mcp.io/badge/john/my-app/vercel)
![Netlify](https://img.shields.io/endpoint?url=https://deploy-mcp.io/badge/john/my-app/netlify)

Webhook Configuration

For real-time badge updates, configure webhooks:

Vercel Webhooks (Pro/Enterprise only)

1. Go to your Vercel team settings 2. Navigate to "Webhooks" section 3. Click "Create Webhook" 4. Configure: - **URL**: `https://deploy-mcp.io/webhook/{username}/{repo}/vercel` - **Events**: Deployment Created, Ready, Error - **Projects**: Select specific or all

Netlify Webhooks

1. Go to Site Settings → Build & deploy → Deploy notifications 2. Add notification → Outgoing webhook 3. Configure: - **URL**: `https://deploy-mcp.io/webhook/{username}/{repo}/netlify` - **Events**: Deploy started, succeeded, failed

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: 1. Explicit platform mention in your command 2. Project/site name matching 3. 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

Contributing

─────────────────────────

We welcome contributions! See CONTRIBUTING.md for guidelines.

Adding New Platforms

Implement the BaseAdapter interface
Add platform-specific API client
Update configuration documentation
Add tests

License

─────────────────────────

Apache 2.0 - See LICENSE for details.

Links

─────────────────────────

Made with ❤️ for developers who love AI-assisted coding

deploy-mcp

Author

alexpota

Quick Info

Actions

Tags

Demo

Quick Start

Supported Platforms

Multi-Platform Configuration

Platform Configuration

Vercel

Netlify

Cloudflare Pages

AI Assistant Configuration

Claude Desktop

VS Code

Cursor AI

Windsurf IDE

Continue.dev

Cline (VS Code Extension)

Deployment Status Badges

Badge Format

Examples by Platform

Vercel Badge

Netlify Badge

Multiple Badges

Webhook Configuration

Available Tools

Core Tools

Platform-Specific Usage

New Features

List Projects

Deployment History

Security

Advanced Configuration

Environment Variables

Custom Installation

Contributing

Adding New Platforms

License

Links

See Also