Vercel MCP Proxy

A single-user MCP server exposing your Vercel account as tools, with its own OAuth layer so Gemini Spark can connect via client_id/client_secret.

Tools exposed

• list_vercel_projects

• list_vercel_deployments

• get_vercel_deployment

• get_vercel_deployment_events (build/runtime logs — useful for monitoring failures)

• redeploy_vercel

Related MCP server: Vercel MCP Relay Server

1. Push to GitHub

Push this folder to its own repo (can be private).

2. Deploy to Render

(Render is just used as the host here — this proxy talks to Vercel's API, it has nothing to do with your Render account.)

1. Render dashboard → New + → Web Service → connect the repo.

2. Runtime Node, build command npm install, start command npm start.

3. Set Environment Variables (see .env.example) — use a placeholder for BASE_URL on first deploy.

4. Deploy, copy the real URL, set BASE_URL to it, redeploy.

3. Connect in Gemini Spark

1. Gemini web → Settings & help → Connected Apps → Custom apps for Spark → Add a custom app.

2. MCP server URL: https://your-real-url.onrender.com/mcp

3. Advanced features → Show more → paste your OAUTH_CLIENT_ID / OAUTH_CLIENT_SECRET.

4. Continue → you'll land on your server's password page → enter ADMIN_PASSWORD → Approve.

Notes

• Single-user only — anyone with your password + OAuth credentials can connect.

• In-memory tokens reset on redeploy/restart — you'll just re-approve once.

• To add more tools (e.g. listing env vars, checking domains), copy the pattern of an existing server.registerTool(...) block and call Vercel's REST API (docs: https://vercel.com/docs/rest-api).