verapli
Sign inJoin free
Menu

Guides · hosting · Everyday developer services

Vercel project and access token

Create a Vercel account and project, deploy from a Git repo or the CLI, and create an access token so scripts and CI can deploy.

Researched · not yet run liveLast researched 25 October 2026 · Vercel · provider site

Researched, not yet run live. Built from the provider’s official pages (linked below). A person hasn’t walked this flow end to end yet, so check each step against the source.
Do this with verapliJSON for agents

Who owns what

A Vercel account owns a personal Hobby team; Pro teams are separate paid teams. Projects live under a team.

  • Vercel account personal owned by the person
  • Team (Hobby or Pro) organisation · under Vercel accountCommercial projects need a Pro or Enterprise team.
  • Project project · under Team (Hobby or Pro)

Have ready

  • A Git repository on GitHub, GitLab or Bitbucket (dashboard route), or Node.js 18+ for the CLI route.
  • A card, only if the project is commercial and needs the Pro plan. · Hobby is restricted to non-commercial personal use; Pro is paid per developer seat. [3]Needed for: Upgrade to Pro if the project is commercial

Steps

Steps marked “human step” are ones only you can do: verapli never signs in, submits, pays or accepts terms for you.

  1. Create or sign in to a Vercel account

    The person signs up at vercel.com/signup (or signs in). verapli never creates the account.

    • Guided by hand
    • Human step: You press submit

    Where: https://vercel.com/signup

  2. Create the project

    Either open the New Project page, connect the Git provider and import the repo, then press Deploy; or install the CLI (npm i -g vercel), run vercel login, and run vercel in the project folder.

    • verapli co-pilot
    • Human step: You press submit
    • After: Create or sign in to a Vercel account

    Where: https://vercel.com/new

  3. Upgrade to Pro if the project is commercialoptional

    In team Settings → Billing, choose Upgrade, enter card details and confirm. Needed for any commercial use.

    • Guided by hand
    • Human step: You add payment details
    • After: Create or sign in to a Vercel account

  4. Create an access token

    On the Tokens page in account settings, create a token with the narrowest scope and an expiry, then let verapli capture it into VERCEL_TOKEN. The token is shown once.

    • verapli co-pilot
    • Human step: You press submit
    • After: Create or sign in to a Vercel account

    verapli captures VERCEL_TOKEN here by plain code: encrypted in your browser, never shown to AI.

    Where: https://vercel.com/account/tokens

  5. Record org and project ids for CIoptional

    Run vercel link in the project folder; the .vercel/project.json it writes holds the org and project ids to set as VERCEL_ORG_ID and VERCEL_PROJECT_ID in CI.

    • Guided by hand
    • After: Create the project

Terms and gotchas

Plain-English summary, not legal advice. Each card links its source.

Can get you bannedThe rules say

Hobby is non-commercial only

Hobby teams are restricted to non-commercial personal use. Any deployment used for anyone's financial gain (taking payments, advertising products, ads, being paid to build or host the site) needs Pro or Enterprise. Donations do not count as commercial. [4]

Worth knowingThe rules say

On Hobby, exceeding a usage limit usually means waiting until 30 days have passed before the feature works again; there is no pay-as-you-go. [3]

What you end up with

Env varSecretFormatWhat it is
VERCEL_TOKENsecretvcp_…Access token read by Vercel CLI (recommended over --token in CI).
VERCEL_ORG_IDnot secretTeam/org id used by the CLI in non-interactive environments.
VERCEL_PROJECT_IDnot secretprj_…Project id (prj_…) used by the CLI to skip project linking.

Pricing

  • Free tier: Hobby is free, up to 200 projects, 100 deployments per day, 100 GB Fast Data Transfer and 1,000,000 function invocations per month.
  • Costs: Pro developer seats are $20 per user per month (viewer seats free), plus usage beyond included credit.

Source [3]

For agents

The same entry as JSON: /api/v1/entries/vercel/project · requirements /api/v1/requirements/vercel/project · terms /api/v1/terms/vercel/project.

Remote MCP (read-only, no auth)
claude mcp add --transport http verapli https://verapli.com/mcp

> "What do I need for Vercel project and access token, and how long will it take?"
  → tools/call requirements { "provider_id": "vercel/project" }

Sources

  1. Getting started with Vercel Prerequisites (Vercel account, Node.js 18+), CLI install and vercel login, deploy with vercel / vercel --prod, dashboard deploy by connecting GitHub, GitLab or Bitbucket, vercel install for Marketplace storage. · accessed 25 October 2026 · official
  2. Vercel CLI Global Options Token authentication via --token or VERCEL_TOKEN (recommended for CI), token page /account/tokens, VERCEL_ORG_ID and VERCEL_PROJECT_ID for non-interactive use, token shape vcp_… · accessed 25 October 2026 · official
  3. Vercel Hobby Plan Hobby is free, included usage, 30-day wait after exceeding limits, Hobby limited to non-commercial personal use, Pro seats $20 per user per month. · accessed 25 October 2026 · official
  4. Fair Use Guidelines Definition of commercial usage that requires Pro or Enterprise. · accessed 25 October 2026 · official
  5. Stripe Projects provider catalogue Vercel is listed in the Stripe Projects catalogue as vercel/project (Hosting). · accessed 25 October 2026 · official

Provider rules change. This page is generated from verapli registry version 2026.1025.316; spotted something out of date? Tell us. Vercel is not affiliated with verapli.