Novo · v1.0 · código aberto

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.

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
Com as suas palavras

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 registerbillable

Pró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-checkread

Aponte 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 listwrite

Transfira 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 transferbillable

Peç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 initializebillable

Diga 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.

Trava de segurança

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.

  1. O agente pergunta primeiro

    Ele chama a ferramenta sem confirm. Nada é enviado. Ele recebe de volta uma prévia da requisição exata.

  2. Você decide

    O agente mostra o domínio, o período e a operação. Você diz sim ou não.

  3. 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
Primeiros passos

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.

  1. Copie um prompt

    Escolha Claude Code, ChatGPT Codex ou o chat comum no topo desta página e copie o prompt.

  2. Cole no seu assistente

    Ele instala o dna, adiciona o servidor MCP e roda o dna doctor para verificar a instalação.

    dna doctor
  3. Faç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 ote
  4. Peç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
Instalação manual

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 | sh

Um ú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

Rode dna mcp config para exibir um trecho pronto para cada cliente.

Cobertura

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.

Veja a referência completa de comandos

Scripts e CI

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
Códigos de saída
0sucesso6limite de requisições
2entrada inválida, nada enviado7erro do servidor
3autenticação8rede
4não encontrado9confirmação necessária
5rejeitado pela API10modo somente leitura
Escolhendo a ferramenta

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.

Perguntas frequentes

O que perguntam antes de conectar um agente

Respostas curtas e diretas. O README no GitHub cobre todos os detalhes.

Leia a documentação completa
O 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.