# 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`

## 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).