┌───────────────────────────────────────────────────────────────────────────────────────────┐
│  ● ● ● terminal — deploy-mcp                                                              │
├───────────────────────────────────────────────────────────────────────────────────────────┤
│                                                                                           │
│   ██████╗ ███████╗██████╗ ██╗      ██████╗ ██╗   ██╗    ███╗   ███╗  ██████╗  ██████╗     │
│   ██╔══██╗██╔════╝██╔══██╗██║     ██╔═══██╗╚██╗ ██╔╝    ████╗ ████║ ██╔════╝  ██╔══██╗    │
│   ██║  ██║█████╗  ██████╔╝██║     ██║   ██║ ╚████╔╝     ██╔████╔██║ ██║       ██████╔╝    │
│   ██║  ██║██╔══╝  ██╔═══╝ ██║     ██║   ██║  ╚██╔╝      ██║╚██╔╝██║ ██║       ██╔═══╝     │
│   ██████╔╝███████╗██║     ███████╗╚██████╔╝   ██║       ██║ ╚═╝ ██║ ╚██████╗  ██║         │
│   ╚═════╝ ╚══════╝╚═╝     ╚══════╝ ╚═════╝    ╚═╝       ╚═╝     ╚═╝  ╚═════╝  ╚═╝         │
│                                                                                           │
│         🔥 Zero-Config Autonomous Vercel Deployment Engine for AI IDEs                    │
│                                                                                           │
└───────────────────────────────────────────────────────────────────────────────────────────┘

🚀 Deploy MCP

Deploy any web application to Vercel — autonomously from your AI IDE in seconds.

Quick Start • About • Brand Design • IDE Setup • Tool Reference • Architecture • Troubleshooting • Official Website

📖 About Deploy MCP

The Vision

In the modern AI coding era, AI assistants like Cursor, VS Code, Antigravity, Windsurf, and Claude Desktop can write complex full-stack web applications in minutes. However, getting those applications shipped to a live production URL has remained a tedious, manual, and error-prone process:

• Developers must leave their IDE, open separate terminal windows, and run confusing CLI login flows.

• Environment variables often get copied by hand or inadvertently pasted into LLM prompts, causing severe security leaks.

• Build failures in cloud pipelines require digging through remote web dashboards to copy-paste cryptic stack traces back into the AI prompt.

The Solution

Deploy MCP bridges this gap entirely. Built on Anthropic's Model Context Protocol (MCP), it turns your AI assistant into an autonomous DevOps engineer that:

1. Detects Frameworks Automatically: Inspects your project structure (Next.js, Vite, React, Vue, Svelte, Remix, static HTML, etc.) without configuration.

2. Validates Builds Locally: Executes a pre-flight dry run build on your machine to catch syntax or bundler errors before touching the cloud.

3. Isolates Secrets Locally: Reads .env keys and syncs them straight to Vercel via secure local REST calls. Confidential values never enter the LLM context window.

4. Deploys Autonomously: Initiates Vercel cloud deployments, polls telemetry status, and provides the live HTTPS production URL.

5. Self-Heals on Error: If a cloud build ever fails, Deploy MCP captures the exact error lines, analyzes the root cause, and provides your AI assistant with actionable instructions to fix the code and redeploy automatically.

Developer:  "Deploy this website."

AI Agent:   ✓ Framework Detected: Next.js (App Router)
            ✓ Pre-Flight Validation: Local build passed (0 errors)
            ✓ Security Check: Git index clean, 0 tracked secrets
            ✓ Secret Sync: Transmitted 4 required env keys directly to Vercel API
            ✓ Deployment Pipeline: Triggered cloud build on Vercel Edge
            ✓ Telemetry Polling: Status READY in 12.8s

            🎉 Production URL Live: https://my-app.vercel.app

Related MCP server: Vercel MCP Relay Server

🎨 Brand Identity & Design Tokens

Deploy MCP is built with an iconic, warm, retro-modern brand identity that avoids generic cyan/blue tech tropes. All official landing pages, CLI tools, and assets share these cohesive design tokens:

/* Deploy MCP Core Color Tokens */
:root {
  --deploy-burnt-orange: #D5380C; /* hsl(14, 89%, 44%) */
  --deploy-warm-ivory:   #FAF6EE; /* hsl(40, 50%, 96%) */
  --deploy-rich-gold:     #F1B333; /* hsl(41, 87%, 57%) */
  --deploy-carbon-black:  #101010; /* hsl(0, 0%, 6%)    */
}

🛠 Technology Stack

Deploy MCP is engineered with modern, robust technologies:

⚡ Quick Start Guide

Set up Deploy MCP in less than 2 minutes:

1️⃣ Step 1 — Run the Interactive Setup Wizard

Open your terminal in any directory and run:

npx @tusharjain-19/deploy-mcp setup

(or: npx deploymcp setup)

What the setup wizard does:

1. 🔑 Connects Vercel: Guides you to get your free Vercel Personal Access Token.

2. 🔒 Encrypts & Stores Locally: Saves your token safely on your local machine (~/.deploy-mcp/config.json).

3. 📋 Prints Ready Configuration: Outputs the exact JSON snippet formatted for your specific AI IDE.

2️⃣ Step 2 — Connect to Your AI IDE

Add the configuration snippet into your IDE settings:

🟧 Cursor IDE

File: %APPDATA%\Cursor\User\settings\cursor_settings.json (Windows) or ~/.cursor/rules/cursor_settings.json (macOS/Linux)

{
  "mcpServers": {
    "deploy": {
      "command": "npx",
      "args": ["-y", "@tusharjain-19/deploy-mcp"]
    }
  }
}

🟩 VS Code / Antigravity / Claude Code

File: settings.json (Press Ctrl+Shift+P / Cmd+Shift+P → Preferences: Open User Settings (JSON))

{
  "claude.mcp.servers": [
    {
      "name": "deploy",
      "command": "npx",
      "args": ["-y", "@tusharjain-19/deploy-mcp"]
    }
  ]
}

🏄 Windsurf / Supermaven

File: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "deploy": {
      "command": "npx",
      "args": ["-y", "@tusharjain-19/deploy-mcp"]
    }
  }
}

🤖 Claude Desktop

File: %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

{
  "mcpServers": {
    "deploy": {
      "command": "npx",
      "args": ["-y", "@tusharjain-19/deploy-mcp"]
    }
  }
}

3️⃣ Step 3 — Instruct Your AI Assistant

Open any web repository in your IDE, open the AI prompt panel, and request:

"Use Deploy MCP to deploy my project to Vercel."

(or simply: "Deploy my website")

🧰 Comprehensive Tool Suite

Deploy MCP provides your AI assistant with 20 purpose-built tools categorized across 6 core modules:

📦 1. Smart Deployment & Pre-Flight Validation

🌐 2. Custom Domain & DNS Management

🔐 3. Secret & Environment Security Isolation

🌿 4. Version Control & Safety Matrix

☁️ 5. Vercel Telemetry & Self-Healing Diagnostics

⚡ 6. System & Version Management

🔒 Architecture & Security Model

Deploy MCP is designed with a Zero-Trust Security Boundary to ensure secrets never leave your local machine or enter LLM training/prompt contexts:

 ┌──────────────────────────────────────────────────────────────────┐
 │  AI IDE (Cursor / VS Code / Antigravity / Windsurf / Claude)     │
 │                                                                  │
 │  Prompt: "Deploy my website to Vercel"                           │
 └─────────────────────────────────┬────────────────────────────────┘
                                   │ MCP Stdio Channel (JSON-RPC)
                                   ▼
 ┌──────────────────────────────────────────────────────────────────┐
 │  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 🎉           │
 └──────────────────────────────────────────────────────────────────┘

Local Secret Isolation

❌  INSECURE ARCHITECTURE (Vulnerable to AI prompt logging):
    .env values ──> LLM Context Window ──> MCP Server ──> Vercel API

✅  DEPLOY MCP ZERO-TRUST MODEL (Isolated locally):
    .env values ─────────[ Local Machine Execution ]─────────> Vercel API
                                     │
                          (AI sees key NAMES only)

🌐 Official Website & Monorepo

The official Deploy MCP landing website is included directly in this repository under website/.

Features included in the website:

• Lenis Smooth Momentum Scrolling (120Hz/144Hz)

• Interactive 3D Earth Globe & Galaxy Simulator with clickable cloud deployment hubs

• Real-Time Interactive CLI Terminal with animated command runner and brand loading dots

• Horizontal Showcase Runway with smooth pinned transition

• Sound Effects Engine & Design Modals (Documentation, Privacy Policy, Terms of Service, Cookie Preferences)

Running the Website Locally

cd website
npm install
npm run dev

Open http://localhost:3000 (or http://localhost:3001) in your browser to view the live site.

🛠 Troubleshooting & Diagnostics

❌ "Vercel not authenticated" or API Token Error

Re-run the setup wizard to refresh your access token:

npx @tusharjain-19/deploy-mcp setup

Ensure your token generated on Vercel Account Tokens has Full Access scope enabled.

❌ "MCP server not detected in IDE"

1. Verify the JSON syntax in your IDE configuration file (settings.json or cursor_settings.json).

2. Perform a full IDE restart (close all active windows and reopen).

3. Test server startup manually in your terminal:

   npx @tusharjain-19/deploy-mcp

   Expected output: 🚀 Deploy MCP server running on stdio

❌ Cloud Build Fails During Compilation

Ask your AI assistant: "Diagnose the build failure and fix it". Deploy MCP will invoke diagnose_build_failure to extract Vercel build logs, pinpoint syntax errors, and guide the AI to correct the code directly.

🗺 Roadmap

• v1.0: Vercel REST deployment, automated framework detection, zero-trust local secret sync, self-healing build diagnostics, custom domain routing, interactive terminal simulator.

• v2.0: Multi-cloud deployment adapters for Cloudflare Pages, Netlify, Railway, and AWS Amplify.

• v2.1: Team collaboration workspaces and staging deployment previews with automated PR comments.

🤝 Contributing

Contributions are warmly welcomed!

# 1. Clone source repository
git clone https://github.com/Tusharjain-19/deploy-mcp.git
cd deploy-mcp

# 2. Install dependencies & build
npm install
npm run build

# 3. Create feature branch
git checkout -b feature/my-new-feature

Please adhere to the signature brand palette (Burnt Orange #D5380C & Warm Ivory #FAF6EE) and run tests before submitting PRs.

📄 License

Distributed under the MIT License. Free for personal, open-source, and commercial projects. See LICENSE for details.

Crafted with care by Tushar Jain
Founder & Maintainer • jaint0910@gmail.com

⭐ Star this repository on GitHub if Deploy MCP accelerated your development workflow!