Vercel Connector

The Vercel connector provides visibility into your Vercel deployments, projects, and domains with 8 live tools and ETL ingestion into the knowledge graph.

Authentication

Vercel uses an API token for authentication. Generate a token from your Vercel account settings.

{
  "name": "Production Vercel",
  "source_type": "vercel",
  "config": {
    "token": "vercel_xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "team_id": "team_xxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

Generating an API Token

1. Go to Vercel Account Settings > Tokens
2. Click Create Token
3. Name it agentcy-connector
4. Set the scope to your team (or personal account)
5. Set expiration as appropriate (no expiration for persistent connectors)
6. Copy the token immediately — it won't be shown again

TIP

If you are on a Vercel Team plan, include the team_id to scope the connector to your team. You can find it in Team Settings > General.

Live Tools (8)

Tool	Description	Arguments
vercel_list_projects	List all projects with framework, repo link, and latest deployment	team_id?, limit?
vercel_get_project	Get detailed project information	project_id
vercel_list_deployments	List recent deployments with status, URL, and commit info	project_id?, state?, limit?
vercel_get_deployment	Get detailed deployment info including build logs URL	deployment_id
vercel_list_domains	List domains with verification status and configuration	project_id?
vercel_get_domain	Get detailed domain info including DNS records	domain
vercel_list_env_vars	List environment variables for a project (values redacted)	project_id, target?
vercel_list_aliases	List deployment aliases and custom domains	project_id?, deployment_id?

Example: Agent Using Vercel Tools

User: "What's the latest deployment status for the frontend project?"

Agent: Let me check the recent deployments.
→ Calls vercel_list_deployments(project_id: "frontend", limit: 5)
→ Returns:
  1. dpl_abc123 — READY — https://frontend-abc123.vercel.app — 2m ago (main, abc1234)
  2. dpl_def456 — ERROR — https://frontend-def456.vercel.app — 45m ago (fix/header, def4567)
→ Reports: "The latest deployment on main is live and healthy.
   However, the previous deployment from the fix/header branch failed."

ETL Ingestion

Nodes Created

Node Label	Properties	Source
VercelProject	name, framework, node_version, repo, created_at, updated_at	Projects API
VercelDeployment	id, url, state, created_at, ready_at, commit_sha, commit_message, branch	Deployments API
VercelDomain	name, verified, configured_by, created_at, nameservers	Domains API
VercelEnvVar	key, target, type (encrypted/plain/secret)	Env Vars API

Relationships Created

Relationship	From	To
HAS_DEPLOYMENT	VercelProject	VercelDeployment
HAS_DOMAIN	VercelProject	VercelDomain
HAS_ENV	VercelProject	VercelEnvVar
DEPLOYED_FROM	VercelDeployment	Repository (GitHub connector)
ROUTES_TO	VercelDomain	VercelDeployment

Graph Queries

-- Find projects with failed recent deployments
MATCH (p:VercelProject)-[:HAS_DEPLOYMENT]->(d:VercelDeployment)
WHERE d.state = "ERROR"
AND d.created_at > datetime() - duration("P1D")
RETURN p.name, d.url, d.commit_message

-- Cross-connector: link Vercel deployments to GitHub PRs
MATCH (d:VercelDeployment)-[:DEPLOYED_FROM]->(r:Repository)-[:HAS_PR]->(pr:PullRequest)
WHERE d.commit_sha = pr.head_sha
RETURN d.url, pr.title, pr.author

-- Find projects without custom domains
MATCH (p:VercelProject)
WHERE NOT (p)-[:HAS_DOMAIN]->()
RETURN p.name

Configuration Reference

Field	Type	Default	Description
token	string	required	Vercel API token
team_id	string	--	Team ID to scope to (omit for personal account)
sync_deployments_depth	int	50	Number of recent deployments to ingest per project
sync_env_vars	bool	true	Include environment variable metadata (values redacted)
sync_domains	bool	true	Include domain data
include_projects	string[]	["*"]	Project name patterns to include
exclude_projects	string[]	[]	Project name patterns to exclude

Troubleshooting

Error	Cause	Fix
401 Unauthorized	Invalid or expired API token	Regenerate the token in Vercel settings
403 Forbidden	Token does not have access to the team	Verify team_id and token scope
404 Not Found	Project or deployment does not exist	Check the project ID or deployment ID
429 Rate Limited	Too many API requests	Wait and retry; Vercel rate limits are per-token
Timeout	Vercel API is slow to respond	Increase sync timeout or reduce sync_deployments_depth

Verifying Access

Test your token from the command line:

# Verify token and list projects
curl -H "Authorization: Bearer vercel_xxxxx" \
  https://api.vercel.com/v9/projects

# Verify team access
curl -H "Authorization: Bearer vercel_xxxxx" \
  "https://api.vercel.com/v9/projects?teamId=team_xxxxx"

# List recent deployments
curl -H "Authorization: Bearer vercel_xxxxx" \
  https://api.vercel.com/v6/deployments?limit=5