---
name: vercel
description: Deploy, manage, and interact with Vercel projects. Use the `vercel` CLI for deployments, project management, logs, and environment variables.
version: 1.0.0
author: Hermes Agent
license: MIT
metadata:
  hermes:
    tags: [Vercel, Deploy, Frontend, Hosting, Projects]
---

# Vercel Management

Use this skill when the user wants to deploy, manage, or inspect Vercel projects, deployments, logs, or configuration.

## Prerequisites

- **Vercel CLI** — installed globally via `npm i -g vercel`
- **Authentication** — requires a Vercel token (set via `vercel login` or `--token` flag)

## Quick Commands

### Project Management
```bash
# List all projects
vercel projects ls

# Inspect a specific project
vercel inspect <project-or-url>
```

### Deployments
```bash
# Deploy from current directory (preview)
vercel --yes

# Deploy to production
vercel --prod --yes

# Deploy with team scope
vercel --scope <team-slug> --prod --yes
```

### Logs
```bash
# View build logs for a deployment
vercel logs <deployment-url-or-id>
```

### Environment Variables
```bash
# List env vars for a project
vercel env ls [environment]

# Add an env var
vercel env add <name> [environment]

# Pull env vars from project to current dir
vercel env pull
```

### Domains
```bash
# List domains for a project
vercel domains ls

# Add a domain
vercel domains add <domain> --scope <project>
```

## MCP Integration

Vercel also provides an MCP server at `https://mcp.vercel.com` that can be configured in Hermes config.yaml:

```yaml
mcp_servers:
  vercel:
    url: "https://mcp.vercel.com"
```

This requires OAuth authentication through the MCP flow (supported by clients like Claude Code, Cursor, etc.).

## Notes

- Deployments require a `vercel.json` or framework config in the project root
- Team-scoped projects need `--scope <team-slug>`
- Preview deployments get unique URLs (e.g., `your-project-abc123.vercel.app`)
- Production deployments use the primary domain
- Use `--yes` to skip interactive prompts