Provides deployment to Vercel from your AI IDE, including project detection, build checks, environment variable syncing, and deployment status tracking.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Deploy MCP Deploy this project to Vercel"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
┌───────────────────────────────────────────────────────────────────────────────────────────┐
│ ● ● ● terminal — deploy-mcp │
├───────────────────────────────────────────────────────────────────────────────────────────┤
│ │
│ ██████╗ ███████╗██████╗ ██╗ ██████╗ ██╗ ██╗ ███╗ ███╗ ██████╗ ██████╗ │
│ ██╔══██╗██╔════╝██╔══██╗██║ ██╔═══██╗╚██╗ ██╔╝ ████╗ ████║ ██╔════╝ ██╔══██╗ │
│ ██║ ██║█████╗ ██████╔╝██║ ██║ ██║ ╚████╔╝ ██╔████╔██║ ██║ ██████╔╝ │
│ ██║ ██║██╔══╝ ██╔═══╝ ██║ ██║ ██║ ╚██╔╝ ██║╚██╔╝██║ ██║ ██╔═══╝ │
│ ██████╔╝███████╗██║ ███████╗╚██████╔╝ ██║ ██║ ╚═╝ ██║ ╚██████╗ ██║ │
│ ╚═════╝ ╚══════╝╚═╝ ╚══════╝ ╚═════╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═╝ │
│ │
│ 🚀 Zero-Config Autonomous Vercel Deployment Engine for AI IDEs │
│ │
└───────────────────────────────────────────────────────────────────────────────────────────┘
Free. Open source. Zero server costs. Engineered for modern developers.
Quick Start • IDE Setup • Tool Reference • Architecture • Troubleshooting
Deploy MCP is an enterprise-grade Model Context Protocol (MCP) server that empowers AI coding assistants—including Cursor, VS Code, Antigravity, Windsurf, and Claude Desktop—to autonomously validate, configure, environment-sync, and deploy web applications to Vercel.
Rather than manually running builds, managing Vercel CLI logins, or copy-pasting environment variables across developer portals, simply ask your AI assistant "Deploy this".
You: "Deploy this website."
AI: ✓ Framework Detected: Next.js (App Router)
✓ Local Build Check: Passed (0 errors)
✓ Git Status Verified: Clean branch & zero tracked secrets
✓ Environment Sync: Uploaded 4 required secrets directly to Vercel
✓ Deployment Triggered: Deployed to Vercel Infrastructure
✓ Health Check: Status READY in 14.2s
🎉 Production URL live at: https://my-app.vercel.appRelated MCP server: Vercel MCP Relay Server
⚡ Zero-Touch Automated Deployments: Automatic framework detection for Next.js, React, Vite, Vue, Svelte, Remix, Static HTML, and more.
🔐 Zero-Trust Local Secret Isolation: Scans local .env keys and syncs them straight to Vercel via secure local REST calls. Secret values are never sent to AI models.
🩺 Self-Healing Build Diagnosis: If a deployment fails on Vercel, Deploy MCP retrieves build logs, identifies exact code errors, and gives your AI model structured fix instructions to redeploy automatically.
🌿 Version Control Safety Matrix: Prevents accidental deployment of uncommitted changes or secret leakage in Git tracking.
🌐 Smart Domain Management: Checks domain availability instantly and suggests optimized alternatives if taken. Manages custom domain bindings and 308 permanent redirects.
Set up Deploy MCP in less than 2 minutes:
Open your terminal and run:
npx deploymcp setup(or: npx deploy-mcp setup / npx @tusharjain-19/deploy-mcp setup)
What this wizard does in 3 easy steps:
🔑 Connects Vercel: Guides you to get your free Vercel Personal Access Token.
🔒 Saves Token Securely: Stores your token safely on your machine (~/.deploy-mcp/config.json).
📋 Gives You IDE Config: Prints the exact JSON snippet ready to copy into your AI IDE!
Copy and paste the appropriate snippet into your IDE's MCP configuration settings:
File: %APPDATA%\Cursor\User\settings\cursor_settings.json (Windows) or ~/.cursor/rules/cursor_settings.json (Mac/Linux)
{
"mcpServers": {
"deploy": {
"command": "npx",
"args": ["-y", "@tusharjain-19/deploy-mcp"]
}
}
}File: settings.json (Press Ctrl+Shift+P → "Open User Settings (JSON)")
{
"claude.mcp.servers": [
{
"name": "deploy",
"command": "npx",
"args": ["-y", "@tusharjain-19/deploy-mcp"]
}
]
}File: ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"deploy": {
"command": "npx",
"args": ["-y", "@tusharjain-19/deploy-mcp"]
}
}
}Open any web project in your IDE, open the AI prompt panel, and request:
"Use Deploy MCP to deploy my project to Vercel."(or simply: "Deploy my website")
Once invoked, Deploy MCP coordinates the full lifecycle end-to-end:
┌────────────────────────────────────────────────────────────────────────┐
│ 1. 🔍 Detect Framework → Scans package.json & directory markers │
│ 2. 🔨 Validate Build → Executes dry-run build locally │
│ 3. 🌿 Audit Git State → Checks uncommitted files & secret leaks │
│ 4. 🔐 Sync Environment → Directly pushes local .env keys to Vercel │
│ 5. 🚀 Trigger Deployment → Calls Vercel REST API │
│ 6. ⏳ Poll Telemetry → Awaits READY status from Vercel servers │
│ 7. 🩺 Self-Diagnose → Reads raw logs & guides code fix if needed │
│ 8. 🎉 Deliver Live Link → Returns active production URL │
└────────────────────────────────────────────────────────────────────────┘Deploy MCP equips your AI assistant with 20 purpose-built tools categorized across 6 core functional modules:
Tool | Capability & Description |
| Master Deployment Pipeline — Detects framework, checks local build, syncs environment keys, triggers deployment, polls status, and auto-diagnoses build errors. |
| Inspects directory structure and configuration to determine project framework (Next.js, Vite, React, Vue, HTML, etc.) and build scripts. |
| Runs local build dry-run validation to ensure clean compilation prior to cloud upload. |
| Generates a full pre-flight audit report covering Git status, build health, and environment synchronization. |
| Permanently deletes a Vercel project with safety confirmation (requires explicit native OS dialog confirmation). |
Tool | Capability & Description |
| Queries Vercel domain registry to verify availability. If taken, automatically computes and presents the top 2 best alternative domain names. |
| Assigns custom domains or Vercel aliases to projects, with optional 308 permanent redirect or old domain removal. |
🛡️ Security Architecture: Environment values remain strictly on your local device. The AI model receives key names and validation metadata only.
Tool | Capability & Description |
| Audits local |
| Performs key diffing between local |
| Securely transmits missing environment variables directly from local environment storage to Vercel REST endpoints. |
| Automatically synthesizes a sanitized |
| Cross-checks runtime environment variables against expected project schema definitions. |
| 🚨 Audits Git index via |
Tool | Capability & Description |
| Returns git repository state, modified file count, current branch, and uncommitted change summary. |
| Stages modified files, generates formatted git commit, and pushes to configured upstream repository. |
Tool | Capability & Description |
| Initiates direct cloud deployment via Vercel REST deployment API endpoints. |
| Polls current deployment pipeline status ( |
| Fetches raw build log stdout/stderr stream from Vercel build nodes. |
| Parses raw error output lines and generates structured, machine-actionable repair instructions for the AI assistant. |
Tool | Capability & Description |
| Queries npm registry for new Deploy MCP releases, features, and performance enhancements. |
Deploy MCP is designed with a Zero-Trust Security Boundary to ensure project secrets and access tokens are never exposed to external AI APIs:
┌──────────────────────────────────────────────────────────────────┐
│ AI IDE (Cursor / VS Code / Antigravity) │
│ │
│ Prompt: "Deploy my website to Vercel" │
└─────────────────────────────────┬────────────────────────────────┘
│ MCP Stdio Channel
▼
┌──────────────────────────────────────────────────────────────────┐
│ Local Deploy MCP Server (Runs strictly on YOUR machine) │
│ │
│ ├── detect_project() → Parses package.json │
│ ├── check_project() → Executes local build check │
│ ├── scan_env() → Reads local .env (Returns KEYS ONLY) │
│ ├── sync_env() → Sends values directly to Vercel API │
│ └── deploy_to_vercel() → Executes Vercel REST deploy call │
└─────────────────────────────────┬────────────────────────────────┘
│ HTTPS (Vercel REST API)
▼
┌──────────────────────────────────────────────────────────────────┐
│ Vercel Global Edge Network │
│ │
│ ├── Encrypts & assigns environment variables │
│ ├── Compiles production asset bundle │
│ └── Returns active HTTPS production deployment URL 🎉 │
└──────────────────────────────────────────────────────────────────┘❌ INSECURE ARCHITECTURE (Secret exposed to LLM context):
.env values → LLM Context Window → MCP Server → Vercel API
✅ DEPLOY MCP ZERO-TRUST MODEL (Secret isolated locally):
.env values ───[ Local Machine Execution ]───> Vercel API
│
(AI sees key NAMES only)Re-run the configuration wizard to refresh your access token:
npx @tusharjain-19/deploy-mcp setupEnsure your token generated on Vercel Account Tokens has Full Access scope enabled.
Validate syntax in your IDE configuration file (settings.json or cursor_settings.json).
Perform a full IDE restart (close all active windows and reopen).
Test server startup manually in terminal:
npx @tusharjain-19/deploy-mcpExpected output: 🚀 Deploy MCP server running on stdio
Ask your AI assistant: "Diagnose the build failure and fix it".
Deploy MCP will invoke diagnose_build_failure to extract Vercel build logs, locate syntax or dependency errors, and guide the AI to edit broken files directly.
Common fixes:
Missing node modules: Run npm install locally.
Node version mismatch: Specify "engines": { "node": "20.x" } inside package.json.
Missing environment keys: Run compare_env and ask AI to sync missing secrets.
.env Files Tracked by GitIf check_env_leak detects .env files in your git repository:
# Untrack sensitive files while preserving local copies
echo ".env" >> .gitignore
echo ".env.local" >> .gitignore
git rm --cached .env .env.local
git commit -m "fix(security): untrack local environment files"To contribute or extend Deploy MCP locally from source:
# 1. Clone source repository
git clone https://github.com/Tusharjain-19/deploy-mcp.git
cd deploy-mcp/mcp-server
# 2. Install dependencies
npm install
# 3. Compile TypeScript
npm run build
# 4. Execute setup wizard
npm run setup
# 5. Run local development mode
npm run devLaunch the official MCP Inspector to test all 20 tools interactively in a web interface without needing an IDE restart:
npx @modelcontextprotocol/inspector npx tsx src/index.tsmcp-server/
├── src/
│ ├── index.ts ← Main MCP Server Entry & Tool Registry
│ │
│ ├── tools/ ← Modular Tool Implementation Suite
│ │ ├── smart-deploy.ts ← Master Deployment Pipeline
│ │ ├── domains.ts ← Domain Availability & Custom DNS Management
│ │ ├── check-project.ts ← Local Compilation & Build Validation
│ │ ├── deploy.ts ← Vercel Deployment REST Client
│ │ ├── diagnose.ts ← Failure Analysis Engine
│ │ ├── env-vars.ts ← Redacted Env Scanner & Diff Engine
│ │ ├── git.ts ← Git Repository Telemetry & Secret Leak Auditor
│ │ ├── logs.ts ← Telemetry & Build Log Extractor
│ │ ├── delete-project.ts ← Safe Project Removal Engine
│ │ └── project-report.ts ← Comprehensive Pre-flight Inspector
│ │
│ ├── vercel/
│ │ └── client.ts ← Native Vercel REST API Client
│ │
│ ├── utils/ ← Shared Helpers, Rate Limiting & Utilities
│ │ ├── config.ts ← Encrypted Local Credentials Manager
│ │ ├── filesystem.ts ← Safe Disk I/O Utilities
│ │ ├── framework-detector.ts ← Project Ecosystem Classifier
│ │ ├── rate-limiter.ts ← Operation Rate Limiter
│ │ └── version-checker.ts ← Registry Release Monitor
│ │
│ └── cli/
│ ├── index.ts ← Executable CLI Entry Point
│ └── setup.ts ← Interactive Config & Token Wizard
│
├── dist/ ← Compiled Production Artifacts
├── package.json
├── tsconfig.json
└── README.mdMilestone | Status | Key Deliverables |
v1.0 | ✅ Production | Vercel REST API deployment, auto-diagnose self-healing, zero-trust env sync, Git security matrix, domain management |
v2.0 | 🔄 Planned | Multi-cloud deployment targets (Netlify, Railway, Render, Cloudflare Pages) & team organization sharing |
Contributions are welcomed! Help build the ultimate deployment tooling for AI pair programmers:
git clone https://github.com/YOUR-USERNAME/deploy-mcp.git
cd deploy-mcp/mcp-server
npm install
git checkout -b feature/amazing-feature
npm run build
git commit -m "feat: add amazing feature"
git push origin feature/amazing-featurePlease open an issue before submitting major structural refactors.
Distributed under the MIT License. Free for commercial and open-source projects. See LICENSE for details.
Crafted with care by Tushar Jain
⭐ Star this repository if Deploy MCP accelerated your development workflow!
This server cannot be deployed
Build, deploy, and sell AI agents for local-service businesses - from your IDE.
AppDeploy turns app ideas described in AI chat into live full-stack web applications
Deploy and host the apps your AI assistant builds — a real server, database, and shareable URL.
