> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Vercel

> Inspect Vercel projects, deployments, and environment variables

## At a glance

* **Availability**: Experimental ([how to enable](/cloud/integrations)).
* **Auth**: API key.
* **Connection**: The key comes from `VERCEL_TOKEN`.
* **Docs**: [https://vercel.com/docs/rest-api](https://vercel.com/docs/rest-api)

## Credentials

Set these per environment. See [Connect an integration](/cloud/integrations).

| Variable       | Required | Description                                                                                                                   |
| -------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `VERCEL_TOKEN` | Yes      | Vercel access token (Account Settings > Tokens) [Docs](https://vercel.com/docs/rest-api/authentication/create-an-auth-token). |

## Setup

1. **Sign in to Vercel**: Go to [https://vercel.com](https://vercel.com) and sign in (the free Hobby plan is sufficient for testing).
2. **Create an access token**: Open Account Settings > Tokens ([https://vercel.com/account/settings/tokens](https://vercel.com/account/settings/tokens)), create a token, choose its scope (personal account or a team), and copy it.
3. **Set the environment variable**: Add the token to your .env as VERCEL\_TOKEN=...
4. **Verify access**: Run List Projects. For team resources, pass the team's ID via the teamId parameter (find it in Team Settings).

* Tokens are sent as 'Authorization: Bearer \<token>'
* To access resources owned by a team, every call must include teamId (or slug) as a query parameter
* Endpoint versions differ per route (v10 projects, v7 deployments list, v13 deployment detail) - this is normal for the Vercel API

Provider API reference: [https://vercel.com/docs/rest-api](https://vercel.com/docs/rest-api)

## Tools

| Tool                       | Access | Description                                                                               |
| -------------------------- | ------ | ----------------------------------------------------------------------------------------- |
| List Projects              | Read   | List projects of the authenticated user or team                                           |
| Get Project                | Read   | Get a project by ID or name                                                               |
| List Deployments           | Read   | List deployments under the authenticated user or team                                     |
| Get Deployment             | Read   | Get a deployment by ID or hostname URL                                                    |
| List Environment Variables | Read   | List the environment variables of a project (values stay encrypted unless decrypt is set) |

## Example prompts

* List my most recent Vercel deployments with their state and target environment.
* Find my Vercel deployments in ERROR state from the last day and tell me which projects are affected.