Skip to main content
skill CX Codex

vercel-dns — Claude Code skill for Vercel DNS

vercel-dns is a Claude Code skill for managing Vercel DNS records through the CLI. It lists, adds, and removes records for mail, subdomains, and domain verification.

MIT 1 installs ★ 256 updated 2026-04-03

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add different-ai/agent-bank --skill vercel-dns -a claude-code
Open on GitHub

What vercel-dns does

The skill guides the agent through Vercel CLI commands for listing DNS records, adding A, AAAA, CNAME, TXT, or MX entries, and removing records by ID. It also covers checking the active team and switching teams. For the 0 Finance project, commands need the --scope prologe option.

Install the Vercel CLI and log in with vercel login first. The domain must use Vercel DNS; a domain in another team or using another DNS provider may not show up in the expected place. For the apex domain, use an empty string '' as the subdomain argument. MX priority is a separate argument. An MX record on the apex routes all incoming mail for that domain, so check the existing mail setup before changing it.

The skill also describes checking public DNS results with dig and finding record IDs before removal. Some records created automatically by Vercel cannot be deleted.

What it helps with

  • list a domain’s DNS records in Vercel
  • add a TXT record for domain verification
  • configure MX and SPF records for email
  • point a subdomain to an external service
  • find which Vercel team contains a domain

Example prompts for the agent

  • List the DNS records for example.com under the prologe team.
  • Add a TXT record to example.com with the verification value google-site-verification=token.
  • Set up an MX record for the inbound subdomain, then check it with dig.

How to install vercel-dns

1Skills CLI (Vercel)

npx skills add different-ai/agent-bank --skill vercel-dns -a claude-code

2Manually: put the files in place

~/.claude/skills/vercel-dns/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/vercel-dns/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about vercel-dns

How do I install vercel-dns in Claude Code?

Run npx skills add different-ai/agent-bank --skill vercel-dns -a claude-code. The skill file is at ~/.claude/skills/vercel-dns/SKILL.md.

What does vercel-dns do?

It guides DNS management for Vercel-hosted domains through the Vercel CLI, including listing, adding, and removing records, and switching teams.

What do I need before using vercel-dns?

Install the Vercel CLI and log in with vercel login. The domain must use Vercel DNS; commands for the 0 Finance project need --scope prologe.

Source text

SKILL.md · MIT
---
name: vercel-dns
description: Manage DNS records for domains hosted on Vercel using the Vercel CLI
license: MIT
compatibility: opencode
metadata:
  service: vercel
  category: infrastructure
---

## What I Do

Manage DNS records for domains hosted on Vercel, including:

- List existing DNS records
- Add new DNS records (A, AAAA, CNAME, TXT, MX, etc.)
- Remove DNS records
- Switch between Vercel teams/accounts

## Prerequisites

- Vercel CLI installed: `npm i -g vercel` or `brew install vercel-cli`
- Logged in: `vercel login`
- Domain must be on Vercel nameservers or have Vercel as DNS provider

## 0 Finance Project

For the 0 Finance project, always use `--scope prologe`:

```bash
vercel dns ls 0.finance --scope prologe
vercel logs www.0.finance --scope prologe
```

## Common Commands

### Check Login & Team

```bash
# Check who you're logged in as
vercel whoami

# List available teams
vercel teams ls

# Switch to a specific team (use slug, not display name)
vercel switch <team-slug>

# Or use --scope flag instead of switching
vercel domains ls --scope prologe
```

### List Domains & Records

```bash
# List all domains in current team/account
vercel domains ls --scope prologe

# List DNS records for a specific domain
vercel dns ls <domain> --scope prologe
```

### Add DNS Records

```bash
# Add A record
vercel dns add <domain> <subdomain> A <ip-address>

# Add CNAME record
vercel dns add <domain> <subdomain> CNAME <target>

# Add TXT record (use quotes for values with special chars)
vercel dns add <domain> <subdomain> TXT '<value>'

# Add MX record with priority
# NOTE: MX priority is a separate argument (not embedded in the value)
vercel dns add <domain> <subdomain> MX <mail-server> <priority>

# Add record at apex (root domain) - use empty string or @
vercel dns add <domain> '' TXT '<value>'
vercel dns add <domain> @ MX mail.example.com 10
```

### Remove DNS Records

```bash
# First list to get record ID
vercel dns ls <domain>

# Remove by record ID
vercel dns rm <record-id>

# Remove with confirmation skip
vercel dns rm <record-id> --yes
```

## Examples

### Add Email DNS Records (MX + SPF)

```bash
# Add MX record for receiving email
# WARNING: Setting MX at the apex (root) will route *all* inbound mail for the domain.
# If the domain already uses Google Workspace / Fastmail / etc, prefer a dedicated subdomain.
vercel dns add example.com '' MX inbound-smtp.us-east-1.amazonaws.com 10

# Safer: use a subdomain for inbound routing
vercel dns add example.com inbound MX inbound-smtp.us-east-1.amazonaws.com 10

# Add SPF record
vercel dns add example.com '' TXT 'v=spf1 include:amazonses.com ~all'
```

### Add DKIM Records for Email Authentication

```bash
# DKIM CNAME records (common for SES, Google Workspace, etc.)
vercel dns add example.com selector._domainkey CNAME selector.dkim.provider.com
```

### Add Domain Verification TXT Record

```bash
# Google/AWS/other service verification
vercel dns add example.com _amazonses TXT 'verification-token-here'
vercel dns add example.com '' TXT 'google-site-verification=token'
```

### Subdomain Setup

```bash
# Point subdomain to a service
vercel dns add example.com api CNAME api.service.com
vercel dns add example.com app A 192.0.2.1
```

## Troubleshooting

### "You don't have permission to list the domain record"

The domain is in a different team. List teams and switch:

```bash
vercel teams ls
vercel switch <correct-team-slug>
```

### Domain Not Listed

- Domain might be in a different team/account
- Domain might not have Vercel as nameservers
- Check with `vercel domains ls`

### Record Not Propagating

- DNS propagation can take up to 48 hours (usually 5-30 minutes)
- Check propagation: `dig +short <record-name> <record-type>` or use dnschecker.org
- Verify record was added: `vercel dns ls <domain>`

## Token Saving Tips

### Fast Verification With `dig`

When a third-party UI says "Looking for DNS records", verify what the public internet sees:

```bash
dig +short TXT resend._domainkey.example.com
dig +short TXT send.example.com
dig +short MX send.example.com
dig +short TXT example.com
```

## Tips

1. Always check which team you're in before making changes
2. Use single quotes around TXT values to preserve special characters
3. For apex/root domain records, use empty string `''` as subdomain
4. Record IDs are shown in `vercel dns ls` output - needed for removal
5. Some records (like those added by Vercel automatically) cannot be removed

© different-ai · MIT · different-ai/agent-bank

Similar skills

All skills for Cloud: AWS, Azure, GCP →

From the same set5

Project sponsors

Companies that keep this analytics open