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

# Vercel

> Manage deployments, domains, environment variables, Edge Config, and team settings across your Vercel projects

# Vercel

Shanone's Vercel integration gives your agent 107 tools covering the full deployment lifecycle — projects, deployments, domains/DNS, environment variables, Edge Config, caching, and team/security administration.

## Getting Started

<Steps>
  <Step title="Connect via OAuth">
    Ask your agent to do something with Vercel (e.g. "list my Vercel projects"), or connect proactively from **Integrations** in the Shanone dashboard.
  </Step>

  <Step title="Authorize with Sign in with Vercel">
    Approve Vercel's OAuth consent screen for the team/account you want Shanone to act on.
  </Step>

  <Step title="Retry your request">
    Once connected, `shanone_execute_tool` calls for `vercel_*` tools will succeed.
  </Step>
</Steps>

## Available Tools

Shanone provides **107 tools** for Vercel, organized into these categories:

<AccordionGroup>
  <Accordion title="Projects">
    `vercel_list_projects`, `vercel_get_project`, `vercel_create_project`, `vercel_delete_project`, `vercel_update_project`, `vercel_pause_project`, `vercel_unpause_project`, `vercel_list_project_domains`, `vercel_add_project_domain`
  </Accordion>

  <Accordion title="Deployments">
    `vercel_list_deployments`, `vercel_get_deployment`, `vercel_cancel_deployment`, `vercel_redeploy`, `vercel_get_deployment_events`, `vercel_get_deployment_logs`, `vercel_promote_deployment`, `vercel_list_deployment_files`, `vercel_get_deployment_file_contents`, `vercel_create_deployment`, `vercel_delete_deployment`, `vercel_get_deployments_extended`, `vercel_get_promote_aliases`
  </Accordion>

  <Accordion title="Edge Config">
    `vercel_list_edge_configs`, `vercel_get_edge_config`, `vercel_create_edge_config`, `vercel_delete_edge_config`, `vercel_get_edge_config_items`, `vercel_update_edge_config_items`, `vercel_create_edge_config_token`, `vercel_list_edge_config_tokens`, `vercel_get_edge_config_token`, `vercel_delete_edge_config_tokens`, `vercel_get_edge_config_item`, `vercel_list_edge_config_backups`, `vercel_get_edge_config_schema`, `vercel_update_edge_config_schema`
  </Accordion>

  <Accordion title="Domain purchasing">
    `vercel_check_domain_availability`, `vercel_get_bulk_domain_availability`, `vercel_buy_domain`, `vercel_buy_domains`, `vercel_list_supported_tlds`, `vercel_get_tld_info`, `vercel_get_tld_price`, `vercel_get_domain_price`
  </Accordion>

  <Accordion title="Cache artifacts">
    `vercel_check_cache_artifact_exists`, `vercel_get_cache_status`, `vercel_get_artifact_info`, `vercel_delete_all_cache_artifacts`, `vercel_record_cache_event`, `vercel_invalidate_cache_by_tags`, `vercel_delete_cache_by_tags`, `vercel_invalidate_cache_by_image`
  </Accordion>

  <Accordion title="Environment variables">
    `vercel_list_env_vars`, `vercel_create_env_var`, `vercel_delete_env_var`, `vercel_update_env_var`, `vercel_list_shared_env_vars`, `vercel_create_shared_env_var`, `vercel_delete_shared_env_var`
  </Accordion>

  <Accordion title="Rolling releases">
    `vercel_get_rolling_release`, `vercel_get_rolling_release_config`, `vercel_update_rolling_release_config`, `vercel_start_rolling_release`, `vercel_complete_rolling_release`, `vercel_abort_rolling_release`, `vercel_approve_rolling_release_stage`
  </Accordion>

  <Accordion title="Auth tokens">
    `vercel_create_auth_token`, `vercel_get_auth_token`, `vercel_delete_auth_token`, `vercel_list_auth_tokens`, `vercel_get_authenticated_user`
  </Accordion>

  <Accordion title="DNS records">
    `vercel_list_dns_records`, `vercel_create_dns_record`, `vercel_update_dns_record`, `vercel_delete_dns_record`
  </Accordion>

  <Accordion title="Domains">
    `vercel_list_domains`, `vercel_get_domain`, `vercel_add_domain`, `vercel_remove_domain`
  </Accordion>

  <Accordion title="Log drains">
    `vercel_list_log_drains`, `vercel_get_log_drain`, `vercel_create_log_drain`, `vercel_delete_log_drain`, `vercel_list_integration_log_drains`
  </Accordion>

  <Accordion title="Team members">
    `vercel_list_team_members`, `vercel_list_project_members`, `vercel_get_team`, `vercel_update_team`
  </Accordion>

  <Accordion title="Security & firewall">
    `vercel_get_attack_status`, `vercel_update_attack_mode`, `vercel_get_firewall_config`, `vercel_list_firewall_events`
  </Accordion>

  <Accordion title="Webhooks">
    `vercel_list_webhooks`, `vercel_get_webhook`, `vercel_create_webhook`, `vercel_delete_webhook`
  </Accordion>

  <Accordion title="Logs & checks">
    `vercel_list_deployment_checks`, `vercel_get_deployment_build_logs`, `vercel_get_runtime_logs`
  </Accordion>

  <Accordion title="Aliases">
    `vercel_list_aliases`, `vercel_list_deployment_aliases`, `vercel_assign_alias`, `vercel_delete_alias`
  </Accordion>

  <Accordion title="User & git integration">
    `vercel_get_user`, `vercel_list_teams`, `vercel_list_git_namespaces`, `vercel_search_git_repositories`
  </Accordion>
</AccordionGroup>

## Common Use Cases

<CardGroup cols={2}>
  <Card title="Deployment triage" icon="rocket">
    List recent deployments, pull build/runtime logs, and diagnose a failed build
  </Card>

  <Card title="Environment setup for a new project" icon="settings-2">
    Create a project, set environment variables, and add a custom domain
  </Card>

  <Card title="Progressive rollout" icon="git-branch">
    Start a rolling release, watch its stages, and approve or abort based on metrics
  </Card>

  <Card title="Domain and DNS management" icon="globe">
    Check availability, purchase a domain, and wire up DNS records for a project
  </Card>
</CardGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="vercel_create_project or vercel_add_domain fails with a permissions error">
    Many project/domain/team tools operate on whichever team the connected Vercel account belongs to. Confirm the right team context with `vercel_list_teams` and `vercel_get_team` before assuming a permissions bug.
  </Accordion>

  <Accordion title="vercel_redeploy or vercel_promote_deployment doesn't seem to take effect">
    Both operate on a specific deployment ID, not "the latest" deployment implicitly — call `vercel_list_deployments` first to confirm you're targeting the deployment you expect.
  </Accordion>

  <Accordion title="Edge Config or cache changes aren't visible right away">
    Edge Config reads are served from a fast, eventually-consistent edge cache; `vercel_update_edge_config_items` can take a short time to propagate globally before `vercel_get_edge_config_items` reflects it everywhere.
  </Accordion>

  <Accordion title="OAuth connection expires unexpectedly">
    Vercel's OAuth tokens are short-lived; if a call fails with an auth error, reconnect from **Integrations** rather than assuming the token is permanent.
  </Accordion>
</AccordionGroup>