Deploy MCP
Provides deployment to Vercel from your AI IDE, including project detection, build checks, environment variable syncing, and deployment status tracking.
Click on "Install 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 MCPDeploy 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.
š Deploy MCP
Deploy any website to Vercel ā straight from your AI IDE, in seconds.
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.appRelated 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 setupThis 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:
Click "Create Token"
Name it anything (e.g.
deploy-mcp)Set scope to Full Access
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 | "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 |
| All-in-one deploy ā detects, checks, syncs env, deploys, polls, and auto-diagnoses failures |
| Detects framework (Next.js, React, Vue, etc.) and build config |
| Validates the project can build successfully |
| Full pre-flight report ā git, build, env, everything |
| 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 |
| Lists all local |
| Shows what's missing on Vercel vs. your local |
| Uploads missing secrets directly from your machine to Vercel |
| Generates a safe |
| Checks your local env against |
| šØ Detects if any |
šæ Git Tools
Tool | What it does |
| Shows branch, uncommitted files, and change count |
| Commits all changes and pushes to remote |
āļø Vercel Tools
Tool | What it does |
| Triggers deployment |
| Polls current deployment status |
| Fetches raw build logs for debugging |
| Parses logs and gives AI-readable fix suggestions |
š Troubleshooting
ā "Vercel not authenticated" or token error
npx @tusharjain-19/deploy-mcp setupRe-run setup and paste a fresh token. Make sure the token has Full Access scope.
ā "MCP not showing up in my IDE"
Double-check the JSON config you pasted ā look for missing commas or brackets
Fully restart your IDE (close all windows, reopen)
Test the server manually:
npx @tusharjain-19/deploy-mcpYou 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ā runnpm installin your projectWrong Node.js version ā add
"engines": { "node": "20" }topackage.jsonMissing 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 devTest All Tools Without an IDE
npx @modelcontextprotocol/inspector npx tsx src/index.tsThis opens a browser UI where you can call every tool manually and see outputs.
Available Scripts
Script | Command | Description |
Build |
| Compile TypeScript to |
Dev |
| Run server directly with tsx |
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 GitHubPlease 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 |
|
No external servers | MCP runs entirely on your machine |
No overwrite without consent |
|
Leak detection |
|
Token stored locally |
|
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.
š tusharjain.in
š @Tusharjain-19
š 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!
This server cannot be installed
Maintenance
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
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to automate Next.js development including project scaffolding, React component generation, API route creation, and full-stack application workflows with TypeScript and Tailwind CSS support.MIT
- FlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to interact with the Vercel REST API to manage projects, deployments, domains, environment variables, and teams through natural language commands.
- FlicenseNot gradedqualityBmaintenanceEnables AI assistants to interact with Vercel API for managing projects, deployments, domains, and environment variables.
- AlicenseAqualityBmaintenanceUniversal deployment tracker for AI assistants, enabling real-time monitoring and management of deployments across Vercel, Netlify, and Cloudflare Pages without context switching.5359Apache 2.0
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.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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