Skip to main content
Glama

šŸš€ Deploy MCP

Deploy any website to Vercel — straight from your AI IDE, in seconds.

npm version License: MIT TypeScript Node.js Vercel

Free. Open source. Zero server costs. Built for vibe coders.

Quick Start • IDE Setup • Tools • Troubleshooting • Contributing


✨ What is Deploy MCP?

Deploy MCP is a free, open-source MCP (Model Context Protocol) server that lets your AI coding assistant (Cursor, VS Code, Antigravity, etc.) deploy your website to Vercel automatically — with full environment variable syncing, build validation, and git safety checks.

Just say "Deploy this" in your AI chat. That's it.

You:  "Deploy this website."

AI:   āœ“ Next.js detected
      āœ“ Build check passed
      āœ“ Environment variables verified (secrets never exposed)
      āœ“ Deployed to Vercel

      šŸŽ‰ Live at: https://my-portfolio.vercel.app

Related MCP server: Vercel MCP Relay Server

⚔ Quick Start — Deploy in 3 Steps

Step 1 — Run Setup (one-time only)

Open your terminal and run:

npx @tusharjain-19/deploy-mcp setup

This will:

  • Ask you for your Vercel Personal Access Token (see how to get it below)

  • Save it securely on your machine

  • Print the exact config to paste into your IDE

How to get your Vercel Token:

  1. Go to vercel.com/account/tokens

  2. Click "Create Token"

  3. Name it anything (e.g. deploy-mcp)

  4. Set scope to Full Access

  5. Copy the token and paste it when the setup wizard asks


Step 2 — Add to Your IDE

Copy the right config for your IDE and add it to your settings file:

Cursor

File location: %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"],
      "disabled": false
    }
  }
}

VS Code + Claude Extension

File location: settings.json (Ctrl+Shift+P → "Open Settings JSON")

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

Antigravity (VS Code + Antigravity AI)

File location: settings.json (Ctrl+Shift+P → "Open Settings JSON")

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

āœ… Restart your IDE after saving the config.


Step 3 — Deploy!

Open your project folder in your IDE and tell the AI:

"Deploy this website"

The AI handles everything from there:

1. Scans your project           → Detects Next.js / React / Vue / etc.
2. Runs build check             → Makes sure your code compiles
3. Checks git status            → Warns if files aren't committed
4. Scans environment variables  → Keys only, values NEVER exposed to AI
5. Syncs missing env vars       → Uploads secrets directly to Vercel
6. Deploys to Vercel            → Triggers the actual deployment
7. Polls until live             → Waits and confirms it's up
8. Returns your live URL šŸŽ‰

šŸ”„ Version Control (Git) — Built In

Deploy MCP has full Git support built in. Your AI can:

What it does

Command to ask AI

Check uncommitted changes

"Check my git status"

Commit & push before deploy

"Commit my changes and deploy"

Detect leaked .env files

"Check if my .env is in git"

Best practice: Always commit your code before deploying. Ask the AI: "Commit my changes with message 'fix: update homepage' and then deploy"

The git tools work automatically during deployment — if you have uncommitted changes, the AI will warn you and ask if you want to commit first.


🧰 Available Tools

Your AI has access to 16 tools across 4 modules:

šŸ“¦ Project Tools

Tool

What it does

smart_deploy

All-in-one deploy — detects, checks, syncs env, deploys, polls, and auto-diagnoses failures

detect_project

Detects framework (Next.js, React, Vue, etc.) and build config

check_project

Validates the project can build successfully

project_report

Full pre-flight report — git, build, env, everything

delete_project

Permanently deletes a Vercel project (requires your manual approval via OS popup)

šŸ” Environment Variable Tools

Security: Secret values never reach the AI. Only key names are shown. Values go directly from your machine to Vercel.

Tool

What it does

scan_env

Lists all local .env variables (names only, values hidden)

compare_env

Shows what's missing on Vercel vs. your local .env

sync_env

Uploads missing secrets directly from your machine to Vercel

create_env_example

Generates a safe .env.example file with all values blanked out

validate_environment_variables

Checks your local env against .env.example requirements

check_env_leak

🚨 Detects if any .env files are accidentally tracked by Git

🌿 Git Tools

Tool

What it does

git_status

Shows branch, uncommitted files, and change count

git_commit_and_push

Commits all changes and pushes to remote

ā˜ļø Vercel Tools

Tool

What it does

deploy_to_vercel

Triggers deployment

get_deployment_status

Polls current deployment status

get_deployment_logs

Fetches raw build logs for debugging

diagnose_build_failure

Parses logs and gives AI-readable fix suggestions


šŸ›  Troubleshooting

āŒ "Vercel not authenticated" or token error

npx @tusharjain-19/deploy-mcp setup

Re-run setup and paste a fresh token. Make sure the token has Full Access scope.


āŒ "MCP not showing up in my IDE"

  1. Double-check the JSON config you pasted — look for missing commas or brackets

  2. Fully restart your IDE (close all windows, reopen)

  3. Test the server manually:

    npx @tusharjain-19/deploy-mcp

    You should see: Deploy MCP server running on stdio


āŒ "Build failed" during deployment

Ask your AI: "Diagnose the build failure and fix it" — the diagnose_build_failure tool will automatically parse the error logs and tell the AI exactly what to fix.

Common causes:

  • Missing npm install → run npm install in your project

  • Wrong Node.js version → add "engines": { "node": "20" } to package.json

  • Missing environment variable → ask AI to sync your env vars


āŒ "Environment variables not syncing"

  • Make sure your Vercel token has Full Access permissions

  • Check that the project name you tell the AI exactly matches your Vercel project name

  • Run: "Compare my local env vars with Vercel" — the AI will show exactly what's missing


āŒ ".env file accidentally in Git"

Ask your AI: "Check if my .env is tracked by git"

The check_env_leak tool will detect it. If found, fix it:

# Remove .env from git tracking (keeps the file locally)
echo ".env" >> .gitignore
echo ".env.local" >> .gitignore
git rm --cached .env
git rm --cached .env.local
git commit -m "fix: remove .env from git tracking"

āŒ "Module not found" error locally

npm install
npm run build

āŒ "Cannot find Vercel CLI"

Deploy MCP uses the Vercel REST API directly — no Vercel CLI needed. But if you want the CLI anyway:

npm install -g vercel

āš™ļø How It Works

 ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”
 │  Your IDE (Cursor / VS Code / Antigravity)      │
 │                                                 │
 │  You say: "Deploy this"                         │
 ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”¬ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜
                     │ MCP Protocol (stdio)
                     ā–¼
 ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”
 │  Deploy MCP Server (runs on YOUR machine)       │
 │                                                 │
 │  ā”œā”€ā”€ detect_project()   → Read package.json     │
 │  ā”œā”€ā”€ check_project()    → Run build locally     │
 │  ā”œā”€ā”€ scan_env()         → Read .env names only  │
 │  ā”œā”€ā”€ sync_env()         → Push secrets directly │
 │  └── deploy_to_vercel() → Trigger deployment    │
 ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”¬ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜
                     │ Vercel REST API
                     ā–¼
 ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”
 │  Vercel                                         │
 │  ā”œā”€ā”€ Finds or creates your project              │
 │  ā”œā”€ā”€ Receives encrypted env vars                │
 │  ā”œā”€ā”€ Builds your site                           │
 │  └── Returns your live URL šŸŽ‰                   │
 ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜

Security Model

āŒ  INSECURE (secret touches the AI):
    .env → AI Model → MCP → Vercel

āœ…  DEPLOY MCP (secret never leaves your machine):
    .env → MCP Process → Vercel API
               ↑
      AI sees key NAMES only, never values

šŸ”§ Development Setup

Want to run Deploy MCP locally from source?

# 1. Clone the repo
git clone https://github.com/Tusharjain-19/deploy-mcp.git
cd deploy-mcp/mcp-server

# 2. Install dependencies
npm install

# 3. Build TypeScript
npm run build

# 4. Run setup wizard
npm run setup

# 5. Start the server (IDEs do this automatically)
npm run dev

Test All Tools Without an IDE

npx @modelcontextprotocol/inspector npx tsx src/index.ts

This opens a browser UI where you can call every tool manually and see outputs.

Available Scripts

Script

Command

Description

Build

npm run build

Compile TypeScript to dist/

Dev

npm run dev

Run server directly with tsx

Setup

npm run setup

Run the setup wizard


šŸ“ Project Structure

mcp-server/
ā”œā”€ā”€ src/
│   ā”œā”€ā”€ index.ts                    ← MCP server entry (all 16 tools registered)
│   │
│   ā”œā”€ā”€ tools/
│   │   ā”œā”€ā”€ smart-deploy.ts         ← All-in-one deploy with auto-diagnose
│   │   ā”œā”€ā”€ check-project.ts        ← Build validation
│   │   ā”œā”€ā”€ deploy.ts               ← Vercel deployment trigger
│   │   ā”œā”€ā”€ diagnose.ts             ← Build failure diagnosis
│   │   ā”œā”€ā”€ env-vars.ts             ← .env scanning, diffing, syncing
│   │   ā”œā”€ā”€ git.ts                  ← Git status, commit, leak detection
│   │   ā”œā”€ā”€ logs.ts                 ← Deployment log fetching
│   │   ā”œā”€ā”€ delete-project.ts       ← Safe project deletion with OS prompt
│   │   └── project-report.ts       ← Master pre-flight report
│   │
│   ā”œā”€ā”€ vercel/
│   │   └── client.ts               ← Vercel REST API wrapper
│   │
│   ā”œā”€ā”€ utils/
│   │   ā”œā”€ā”€ config.ts               ← Token storage/retrieval
│   │   ā”œā”€ā”€ filesystem.ts           ← File reading utilities
│   │   └── framework-detector.ts   ← Framework & package manager detection
│   │
│   └── cli/
│       ā”œā”€ā”€ index.ts                ← CLI entry point
│       └── setup.ts                ← Interactive setup wizard
│
ā”œā”€ā”€ dist/                           ← Compiled JS (auto-generated, git-ignored)
ā”œā”€ā”€ package.json
ā”œā”€ā”€ tsconfig.json
└── README.md

šŸ—ŗ Roadmap

Version

Status

Features

v1.0

āœ… Done

Project detection, build check, Vercel deployment, status polling

v1.5

āœ… Done

Env scanning (no leakage), env diff, env sync, git tools, project report

v1.6

āœ… Done

Smart deploy (auto-diagnose failures), safe project deletion

v2.0

šŸ”„ Planned

AI error auto-fix loop, preview deployments, rollback

v3.0

šŸ’­ Future

Netlify/Railway support, GitHub integration, team deployments


šŸ”„ Automatic Updates

Because your IDE config uses npx -y @tusharjain-19/deploy-mcp, Node.js will automatically pull the latest version from npm every time your IDE starts the server. No manual update commands needed — you always get the latest features and fixes automatically.


šŸ¤ Contributing

Contributions are welcome! This is a free, open-source project built for the community.

# Fork the repo, then:
git clone https://github.com/YOUR-USERNAME/deploy-mcp.git
cd deploy-mcp/mcp-server
npm install

# Create a feature branch
git checkout -b feature/my-feature

# Make changes, then build and test
npm run build

# Commit and push
git commit -m "feat: add my feature"
git push origin feature/my-feature

# Open a Pull Request on GitHub

Please open an issue first for large changes. Bug fixes and docs improvements are always welcome!


šŸ” Security

Principle

How it's implemented

Secrets never touch the AI

scan_env returns only key names + classifications

No external servers

MCP runs entirely on your machine

No overwrite without consent

sync_env skips existing Vercel vars by default

Leak detection

check_env_leak scans git ls-files before deploy

Token stored locally

~/.deploy-mcp/config.json — your machine only

No hardcoded credentials

Zero hardcoded tokens in the codebase


šŸ‘Øā€šŸ’» About

Built by Tushar Jain — tools that bridge the gap between AI and shipping real products.


šŸ“„ License

MIT License — 100% free forever. Use it in commercial projects, modify it, distribute it. See LICENSE for full text.


Built with ā¤ļø for vibe coders everywhere

⭐ Star this repo if it saved you time!

GitHub stars

F
license - not found
Not graded
quality - not tested
B
maintenance

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.

  • Your AI builds, deploys, and runs full-stack apps on a hosted workspace created at first sign-in.

  • Form companies, manage bank accounts, cards, invoices and more — directly from your AI coding tools.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Tusharjain-19/deploy-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server