A CLI de domínios e o servidor MCP feitos para agentes de IA
O dna é a ferramenta de linha de comando e o servidor MCP oficiais da Domain Name API. Copie um prompt pronto para o Claude ou o ChatGPT e o seu assistente instala o dna, faz a conexão e começa a trabalhar nos seus domínios, DNS, SSL e hospedagem. Tudo o que custa dinheiro espera o seu sim.
Configure o dna no Claude Code
Configure a CLI do dna para mim (https://github.com/domainreseller/cli). 1. Instale com o script de instalação oficial para o meu sistema operacional e depois rode `dna version` e `dna doctor`. 2. Instale a skill do Claude Code com `dna agent skill --install` e adicione o servidor MCP com `claude mcp add dna -- dna mcp serve --env ote`. 3. Não me peça para colar a minha chave de API neste chat. Diga para eu rodar `dna auth login --env ote` por conta própria e depois verifique a conexão com `dna --ote account get`. Trabalhe só no ambiente de testes OTE e nunca use `--yes` sem a minha aprovação.
Configure o dna no ChatGPT Codex
Configure a CLI do dna para mim (https://github.com/domainreseller/cli). 1. Instale com o script de instalação oficial para o meu sistema operacional e depois rode `dna version` e `dna doctor`. 2. Adicione o dna à minha configuração do Codex (`~/.codex/config.toml`) como um servidor MCP chamado `dna`, com o comando `dna` e os argumentos `mcp serve --env ote`. 3. Não me peça para colar a minha chave de API neste chat. Diga para eu rodar `dna auth login --env ote` por conta própria e depois verifique a conexão com `dna --ote account get`. Trabalhe só no ambiente de testes OTE e nunca use `--yes` sem a minha aprovação.
Sem terminal? Peça ao ChatGPT ou ao Claude no chat
Leia https://raw.githubusercontent.com/domainreseller/cli/main/llms.txt e a documentação do dna para a qual ele aponta. Depois me passe os comandos exatos do dna, passo a passo, para registrar um domínio no ambiente de testes OTE: instalação, login, busca, prévia com `--dry-run` e registro. Explique o que cada comando faz.
Copie um prompt, cole no seu assistente de IA e deixe que ele faça o trabalho. Todo prompt começa no ambiente de testes OTE e aguarda a sua aprovação antes de qualquer operação com cobrança.
- 64operações da API
- 65ferramentas MCP
- 4classes de segurança
- 6plataformas, um só binário
- Apache-2.0licença de código aberto
Prompts prontos para o Claude e o ChatGPT
Troque os nomes de domínio, cole um prompt no seu assistente e acompanhe o trabalho. Cada prompt diz onde parar, então nada com cobrança acontece sem você.
Encontre e registre um domínio
Com o dna, verifique se brandname.com, brandname.net e brandname.io estão disponíveis. Mostre os resultados com os preços em uma tabela e depois faça uma prévia, com `--dry-run`, do registro do mais barato entre os disponíveis. Não registre nada até eu dizer sim.
domain bulk-search · domain registerbillablePróximas renovações
Com o dna, liste os meus domínios que vencem nos próximos 60 dias, com os preços de renovação, ordenados pela data de vencimento. Não renove nada.
domain list · domain renew-checkreadAponte um domínio para um servidor
Com o dna, aponte example.com para 203.0.113.10: adicione registros A para `@` e `www` e depois me mostre a zona DNS final. Me consulte antes de alterar ou excluir qualquer registro existente.
dns add · dns listwriteTransfira um domínio para a sua conta
Com o dna, verifique se example.org pode ser transferido para a minha conta, me diga o que ainda falta (código de transferência, desbloqueio) e faça uma prévia da transferência com `--dry-run`.
domain transfer-check · domain transferbillablePeça um certificado SSL
Com o dna, encontre o certificado DV SSL mais barato para example.com, gere um CSR e faça uma prévia do pedido. Espere a minha aprovação antes de comprar.
product ssls · ssl generate-csr · ssl initializebillableDiga do que precisa. Seu agente encontra o comando certo.
Cada operação da API é uma ferramenta com uma descrição clara e um esquema JSON, então os assistentes escolhem a chamada certa e a preenchem corretamente logo de primeira. Você fala, e o dna faz o trabalho com precisão.
Seu agente não gasta um centavo sem você
Cada comando tem uma classe de segurança, e é a classe que decide o que acontece. Consultas e alterações gratuitas e reversíveis rodam na hora. Tudo o que é debitado do seu saldo ou não pode ser desfeito fica em espera e pergunta primeiro.
- read
Leitura
Busca, listagens, informações de domínio, preços e regras das extensões.
Roda na hora - write
Escrita
Registros DNS, bloqueio de transferência, privacidade WHOIS e contatos. Gratuito e reversível.
Roda na hora - destructive
Destrutiva
Excluir um registro, revogar um certificado SSL, desativar o DNSSEC.
Espera a sua aprovação - billable
Com cobrança
Registro, renovação, transferência, restauração, pedidos de SSL e de hospedagem.
Espera a sua aprovação
Como funciona a aprovação
As ferramentas protegidas recebem um campo confirm extra. A maioria dos clientes MCP também pergunta a você antes de cada chamada de ferramenta; as anotações de segurança ajudam esses clientes a sinalizar as arriscadas.
O agente pergunta primeiro
Ele chama a ferramenta sem confirm. Nada é enviado. Ele recebe de volta uma prévia da requisição exata.
Você decide
O agente mostra o domínio, o período e a operação. Você diz sim ou não.
Roda uma única vez
Só depois do seu sim ele repete a chamada com confirm=true. Uma chamada com cobrança nunca é reenviada após um erro de rede.
Defina até onde ele pode ir
--env ote- Ambiente de testes: a API real, sem dinheiro real
--read-only- Olhar sem mexer. Toda alteração é bloqueada.
--no-billable- Tudo, menos compras
--groups domain,dns- Só os grupos de comandos que você listar
--dry-run- Mostra a requisição HTTP exata, com a chave de API mascarada
Do prompt ao primeiro domínio em quatro passos, tudo no ambiente de testes
O OTE é o nosso ambiente de testes: a mesma API, com chave de API e saldo próprios. Pratique lá e depois passe para produção com uma única flag.
Copie um prompt
Escolha Claude Code, ChatGPT Codex ou o chat comum no topo desta página e copie o prompt.
Cole no seu assistente
Ele instala o dna, adiciona o servidor MCP e roda o dna doctor para verificar a instalação.
dna doctorFaça login no OTE por conta própria
Rode o comando de login no seu próprio terminal e digite ali o seu ID de revendedor e a chave de API do OTE, nunca no chat.
dna auth login --env otePeça com as suas palavras
Pesquise, gere uma prévia com --dry-run, registre. Tudo o que é debitado do saldo de testes espera o seu sim.
--dry-run
Prefere o terminal? Conecte em dois comandos
Instale o binário e depois adicione dna mcp serve ao seu cliente MCP. Cada operação da API vira uma ferramenta para Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex CLI ou Gemini CLI.
$ curl -fsSL https://raw.githubusercontent.com/domainreseller/cli/main/scripts/install.sh | shPS> irm https://raw.githubusercontent.com/domainreseller/cli/main/scripts/install.ps1 | iex$ go install github.com/domainreseller/cli/cmd/dna@latestUm único binário, sem dependências. Cada versão é publicada com checksums SHA-256.
- Uma ferramenta por operação da API, cada uma com um esquema JSON gerado a partir da especificação da API
- O dna_context informa ao modelo se ele está em produção ou no ambiente de testes antes de mexer em qualquer coisa
- Exponha só o que você precisa com --groups ou --read-only. Uma lista de ferramentas menor também economiza tokens de contexto.
- Agentes que só têm um shell recebem uma skill do Claude Code e um guia de uso com uma única chamada
# conecte-se primeiro ao ambiente de testes
$ claude mcp add dna -- dna mcp serve --env ote
# somente leitura, compartilhado com a equipe via .mcp.json
$ claude mcp add dna --scope project -- dna mcp serve --env ote --read-only {
"mcpServers": {
"dna": {
"command": "dna",
"args": ["mcp", "serve", "--env", "ote"]
}
}
} {
"servers": {
"dna": {
"type": "stdio",
"command": "dna",
"args": ["mcp", "serve", "--env", "ote"]
}
}
} [mcp_servers.dna]
command = "dna"
args = ["mcp", "serve", "--env", "ote"] # skill do Claude Code: ~/.claude/skills/dna/SKILL.md
$ dna agent skill --install
# um guia compacto para as instruções de qualquer agente
$ dna agent guide Rode dna mcp config para exibir um trecho pronto para cada cliente.
Todas as 64 operações da API, agrupadas do jeito que você pensa
Se a API de revendedor faz, o dna também faz. O --help de cada comando mostra a classe de segurança, a rota da API e exemplos.
dna domain
Busca simples e em lote, registro, renovação, transferência e restauração. Bloqueio de transferência, privacidade WHOIS, código de transferência (auth), servidores de nomes, hosts filhos e redirecionamento.
dna dns · dna dnssec
Registros de zona nos servidores de nomes da plataforma e registros DS no registry.
dna ssl
Gere um CSR, compre, configure, consulte o status, baixe, reemita e revogue certificados.
dna hosting
Planos e pacotes de hospedagem, novos pedidos e o status de cada um.
dna contact
Contatos reutilizáveis e a verificação do e-mail e do telefone deles.
dna account · product · order
Saldo e transações, o catálogo de extensões com preços e o status dos pedidos.
dna api
Uma requisição bruta e autenticada a qualquer endpoint, com as mesmas regras de segurança.
dna schema · enums · agent
Descrições legíveis por máquina de cada operação, entrada e valor codificado, para agentes e para quem cria ferramentas.
Feito para pipes, cron jobs e pipelines
No terminal, você recebe tabelas legíveis. Num pipe, JSON. Os erros também vêm em JSON, com códigos de saída que nunca mudam de significado, então um script sempre sabe o que deu errado.
- JSON quando a saída vai para um pipe, JSON Lines para streams e um --jq embutido para enxugar a saída
- Credenciais de DNA_RESELLER_ID e DNA_API_KEY no CI, de um perfil na sua própria máquina
- Nada de perguntas escondidas fora de um terminal: um comando protegido sai com o código 9 e não envia nada
- As entradas são validadas antes de qualquer envio e, se bater no limite de requisições, ele tenta de novo sozinho
# domínios que vencem nos próximos 30 dias, em CSV
$ dna domain list --all \
--jq '.items[] | select(.remainingDay <= 30) | [.domainName, .expirationDate] | @csv'
# verifique vários nomes de uma vez
$ dna domain bulk-search brand.com brand.net brand.io \
--jq '.infos[] | "\(.domainName)\t\(.status)\t\(.price)"'
# num script, uma compra sem --yes é barrada aqui
$ dna domain renew example.com --period 1
exit 9 confirmation required · nothing sent | 0 | sucesso | 6 | limite de requisições |
|---|---|---|---|
| 2 | entrada inválida, nada enviado | 7 | erro do servidor |
| 3 | autenticação | 8 | rede |
| 4 | não encontrado | 9 | confirmação necessária |
| 5 | rejeitado pela API | 10 | modo somente leitura |
CLI, SDK, REST API ou módulo pronto?
Todos falam com a mesma API de revendedor, com as mesmas credenciais. Escolha o que combina com o lugar onde o trabalho acontece.
CLI e servidor MCP
Quando quem faz o trabalho é uma pessoa, um script ou um agente de IA: operações do dia a dia, automação, CI e assistentes como o Claude ou o Cursor.
SDKs
Quando você integra recursos de domínio ao seu próprio aplicativo. PHP, Node.js, Python, Ruby e Go.
Conheça os SDKsREST API
Quando você quer controle total sobre cada requisição, em qualquer linguagem. JSON sobre HTTPS com dois cabeçalhos.
Leia o guia da APIMódulos de faturamento
Quando você vende pelo WHMCS, Blesta, HostBill, WiseCP ou Clientexec e quer que tudo funcione sozinho.
Veja as integraçõesO que perguntam antes de conectar um agente
Respostas curtas e diretas. O README no GitHub cobre todos os detalhes.
Leia a documentação completaO que é a CLI da Domain Name API?
O dna é o cliente de linha de comando e servidor MCP oficial da plataforma de revenda da Domain Name API. Ele cobre todas as 64 operações da REST API de revendedor, da pesquisa, registro, renovação e transferência de domínios até DNS, DNSSEC, contatos, SSL e hospedagem, em um único binário de código aberto para macOS, Linux e Windows, sob a licença Apache-2.0.
É seguro deixar um agente de IA registrar domínios?
Sim, porque o agente não consegue comprar nada sozinho. Operações com cobrança e destrutivas retornam uma prévia em vez de serem executadas. Elas só rodam depois que você aprova e a chamada leva confirm=true, ou --yes na CLI. Comece os agentes no ambiente de testes OTE e restrinja ainda mais o acesso com --read-only ou --no-billable.
Posso testar sem gastar dinheiro?
Sim. Com --env ote, o dna se conecta ao OTE, nosso ambiente de testes. Ele tem chave de API e saldo próprios, e nada do que você faz lá afeta domínios ativos ou a sua conta real.
Quais assistentes de IA funcionam com o dna?
Qualquer cliente MCP: Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, OpenAI Codex CLI, Gemini CLI e outros. Agentes que só têm um shell podem chamar a CLI diretamente; o dna agent guide e a skill do Claude Code ensinam como.
Preciso de uma conta na Domain Name API?
Sim. O dna funciona com uma conta de revendedor e as credenciais de API dela: seu ID de revendedor e uma chave de API, ambos em Configurações de API no painel de revendedor. Produção e OTE têm chaves diferentes, e o e-mail e a senha do seu painel não funcionam aqui.
O dna é gratuito?
Sim. A ferramenta é gratuita e de código aberto, sob a licença Apache-2.0. Você só paga pelo que compra por meio dela, como domínios, renovações, SSL e hospedagem, com os seus preços de revendedor e usando o saldo da sua conta.
Onde ficam guardadas as minhas credenciais?
O dna auth login as salva em um arquivo de perfil na pasta de configuração do seu usuário, que só você pode ler no Linux e no macOS; o dna config path mostra onde fica. As variáveis de ambiente sempre têm prioridade, e a chave de API aparece mascarada em toda saída, inclusive no --dry-run.
Posso usar o dna em scripts e no CI?
Sim. A saída é JSON quando vai para um pipe, os erros vêm em JSON com códigos de saída estáveis e não há perguntas fora de um terminal interativo. Passe as credenciais como DNA_RESELLER_ID e DNA_API_KEY. Um comando com cobrança sem --yes sai com o código 9 e não envia nada.
Devo usar a CLI ou um SDK?
Use o dna quando quem faz o trabalho é uma pessoa, um script ou um agente de IA. Use um SDK para PHP, Node.js, Python, Ruby ou Go, ou a própria REST API, quando você integra recursos de domínio ao seu próprio aplicativo. Todos usam a mesma API e as mesmas credenciais.
Preciso usar o terminal?
Não. Cole um prompt pronto no Claude Code, que também roda no app do Claude para desktop, ou no ChatGPT Codex, e o assistente instala e conecta o dna para você. O único comando que você digita é o dna auth login, então a sua chave de API nunca vai para o chat. Se você não tiver terminal nenhum, o prompt de chat guia você por cada etapa.
