# Vercel MCP Relay Server
A production-ready MCP (Model Context Protocol) relay server that enables GitHub Copilot Agents and other AI assistants to interact with the Vercel REST API.
## Features
- **Full Vercel API Coverage**: Manage projects, deployments, domains, environment variables, teams, and more
- **Production Ready**: Built for Vercel's serverless platform with optimal configuration
- **Streamable HTTP Transport**: Uses the modern MCP transport protocol for efficient communication
- **Type Safe**: Written in TypeScript with comprehensive schema validation using Zod
## Quick Start
### Deploy to Vercel
[](https://vercel.com/new/clone?repository-url=https://github.com/econ-watch/MCP)
### Environment Variables
Set the following environment variable in your Vercel project:
- `VERCEL_TOKEN`: Your Vercel API token ([create one here](https://vercel.com/account/tokens))
### Local Development
```bash
# Install dependencies
npm install
# Set your Vercel token
export VERCEL_TOKEN=your_token_here
# Start development server
npm run dev
```
The MCP server will be available at `http://localhost:3000/api/mcp`
## Available Tools
### Projects
| Tool | Description |
|------|-------------|
| `list_projects` | List all Vercel projects accessible to the authenticated user |
| `get_project` | Get detailed information about a specific project |
### Deployments
| Tool | Description |
|------|-------------|
| `list_deployments` | List deployments for a project or all deployments |
| `get_deployment` | Get detailed information about a specific deployment |
| `get_deployment_events` | Get build logs and events for a deployment |
| `cancel_deployment` | Cancel a deployment that is currently building |
| `promote_deployment` | Promote a deployment to production |
| `rollback_deployment` | Rollback a project to a previous deployment |
### Environment Variables
| Tool | Description |
|------|-------------|
| `list_environment_variables` | List all environment variables for a project |
| `create_environment_variable` | Create a new environment variable |
| `delete_environment_variable` | Delete an environment variable |
### Domains
| Tool | Description |
|------|-------------|
| `list_project_domains` | List all domains configured for a project |
| `add_project_domain` | Add a custom domain to a project |
| `remove_project_domain` | Remove a domain from a project |
| `verify_project_domain` | Verify a domain's DNS configuration |
### Teams & User
| Tool | Description |
|------|-------------|
| `list_teams` | List all teams the authenticated user is a member of |
| `get_team` | Get detailed information about a specific team |
| `get_user` | Get information about the authenticated user |
### Aliases
| Tool | Description |
|------|-------------|
| `list_aliases` | List all aliases (custom URLs) for a deployment or project |
## Usage with MCP Clients
### GitHub Copilot / Claude Desktop
Add to your MCP configuration:
```json
{
"mcpServers": {
"vercel": {
"url": "https://your-deployment.vercel.app/api/mcp"
}
}
}
```
### For clients requiring stdio transport
```json
{
"mcpServers": {
"vercel": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://your-deployment.vercel.app/api/mcp"]
}
}
}
```
## Tech Stack
- [Next.js](https://nextjs.org/) - React framework for serverless deployment
- [@vercel/mcp-adapter](https://www.npmjs.com/package/@vercel/mcp-adapter) - Vercel's MCP server adapter
- [Zod](https://zod.dev/) - TypeScript-first schema validation
- [Model Context Protocol](https://modelcontextprotocol.io/) - Open protocol for AI tool integration
## Security
- The `VERCEL_TOKEN` is kept server-side and never exposed to clients
- All API requests are authenticated using Bearer token authentication
- Input parameters are validated using Zod schemas
## License
MIT
