La CLI de dominios y el servidor MCP creados para agentes de IA
dna es la herramienta de línea de comandos y el servidor MCP oficiales de Domain Name API. Copia un prompt listo para usar en Claude o ChatGPT y tu asistente lo instala, lo conecta y se pone a trabajar con tus dominios, DNS, SSL y hosting. Todo lo que cuesta dinero espera tu visto bueno.
Configura dna en Claude Code
Configúrame la CLI de dna (https://github.com/domainreseller/cli). 1. Instálala con el script de instalación oficial para mi sistema operativo y luego ejecuta `dna version` y `dna doctor`. 2. Instala la skill de Claude Code con `dna agent skill --install` y añade el servidor MCP con `claude mcp add dna -- dna mcp serve --env ote`. 3. No me pidas que pegue mi clave API en este chat. Dime que ejecute `dna auth login --env ote` por mi cuenta y luego comprueba la conexión con `dna --ote account get`. Trabaja solo en el entorno de pruebas OTE y no uses nunca `--yes` sin mi aprobación.
Configura dna en ChatGPT Codex
Configúrame la CLI de dna (https://github.com/domainreseller/cli). 1. Instálala con el script de instalación oficial para mi sistema operativo y luego ejecuta `dna version` y `dna doctor`. 2. Añádela a mi configuración de Codex (`~/.codex/config.toml`) como servidor MCP llamado `dna`, con el comando `dna` y los argumentos `mcp serve --env ote`. 3. No me pidas que pegue mi clave API en este chat. Dime que ejecute `dna auth login --env ote` por mi cuenta y luego comprueba la conexión con `dna --ote account get`. Trabaja solo en el entorno de pruebas OTE y no uses nunca `--yes` sin mi aprobación.
¿Sin terminal? Pídeselo a ChatGPT o a Claude en el chat
Lee https://raw.githubusercontent.com/domainreseller/cli/main/llms.txt y la documentación de dna a la que enlaza. Después dame los comandos de dna exactos, paso a paso, para registrar un dominio en el entorno de pruebas OTE: instalación, inicio de sesión, búsqueda, vista previa con `--dry-run` y registro. Explica qué hace cada comando.
Copia un prompt, pégalo en tu asistente de IA y deja que haga el trabajo. Todos los prompts empiezan en el entorno de pruebas OTE y se detienen a esperar tu visto bueno antes de cualquier operación de pago.
- 64operaciones de la API
- 65herramientas MCP
- 4clases de seguridad
- 6plataformas, un solo binario
- Apache-2.0licencia de código abierto
Prompts listos para usar con Claude y ChatGPT
Cambia los nombres de dominio, pega un prompt en tu asistente y míralo trabajar. Cada uno indica dónde detenerse, así que nada de pago ocurre sin ti.
Busca y registra un dominio
Con dna, comprueba si brandname.com, brandname.net y brandname.io están disponibles. Muestra los resultados con sus precios en una tabla y luego haz una vista previa con `--dry-run` del registro del más barato de los disponibles. No registres nada hasta que te diga que sí.
domain bulk-search · domain registerbillablePróximas renovaciones
Con dna, dame la lista de mis dominios que caducan en los próximos 60 días, con sus precios de renovación y ordenados por fecha de caducidad. No renueves nada.
domain list · domain renew-checkreadApunta un dominio a un servidor
Con dna, apunta example.com a 203.0.113.10: añade registros A para `@` y `www` y luego muéstrame la zona DNS final. Pregúntame antes de cambiar o borrar cualquier registro existente.
dns add · dns listwriteTransfiere un dominio a tu cuenta
Con dna, comprueba si example.org se puede transferir a mi cuenta, dime qué me falta todavía (código de transferencia, desbloqueo) y haz una vista previa de la transferencia con `--dry-run`.
domain transfer-check · domain transferbillablePide un certificado SSL
Con dna, busca el certificado DV SSL más barato para example.com, crea un CSR y haz una vista previa del pedido. Espera mi aprobación antes de comprar.
product ssls · ssl generate-csr · ssl initializebillableDi lo que necesitas. Tu agente encuentra el comando correcto.
Cada operación de la API es una herramienta con una descripción clara y un esquema JSON, así que los asistentes eligen la llamada correcta y la rellenan bien a la primera. Tú hablas; dna hace exactamente lo que hace falta.
Tu agente no puede gastar ni un céntimo sin ti
Cada comando tiene una clase de seguridad, y la clase decide qué pasa. Las consultas y los cambios gratuitos y reversibles se ejecutan al momento. Todo lo que se descuenta de tu saldo o no se puede deshacer se detiene y te pregunta antes.
- read
Lectura
Búsquedas, listados, información de dominios, precios y reglas de las extensiones.
Se ejecuta al momento - write
Escritura
Registros DNS, bloqueo de transferencia, privacidad WHOIS y contactos. Gratuito y reversible.
Se ejecuta al momento - destructive
Destructiva
Borrar un registro, revocar un certificado SSL, desactivar DNSSEC.
Espera tu visto bueno - billable
De pago
Registro, renovación, transferencia, restauración, pedidos de SSL y de hosting.
Espera tu visto bueno
Cómo funciona la confirmación
Las herramientas protegidas llevan un campo confirm adicional. La mayoría de los clientes MCP también te preguntan antes de cada llamada a una herramienta; las anotaciones de seguridad les ayudan a señalar las arriesgadas.
El agente pregunta primero
Llama a la herramienta sin confirm. No se envía nada. Recibe una vista previa de la solicitud exacta.
Tú decides
El agente te muestra el dominio, el periodo y la operación. Tú dices sí o no.
Se ejecuta una vez
Solo después de tu sí repite la llamada con confirm=true. Una llamada de pago nunca se reenvía tras un error de red.
Decide hasta dónde puede llegar
--env ote- Entorno de pruebas: la API real, sin dinero real
--read-only- Mirar sin tocar. Cualquier cambio queda bloqueado.
--no-billable- Todo menos las compras
--groups domain,dns- Solo los grupos de comandos que indiques
--dry-run- Imprime la solicitud HTTP exacta con la clave API enmascarada
Del prompt a tu primer dominio en cuatro pasos, todo en el entorno de pruebas
OTE es nuestro entorno de pruebas: la misma API, con su propia clave API y su propio saldo. Practica allí y luego pasa a producción con una sola opción.
Copia un prompt
Elige Claude Code, ChatGPT Codex o el chat normal en la parte superior de esta página y copia el prompt.
Pégalo en tu asistente
El asistente instala dna, añade el servidor MCP y ejecuta dna doctor para comprobar la instalación.
dna doctorInicia sesión en OTE por tu cuenta
Ejecuta el comando de inicio de sesión en tu propia terminal e introduce allí tu ID de revendedor y tu clave API de OTE, nunca en el chat.
dna auth login --env otePídelo con tus propias palabras
Busca, previsualiza con --dry-run, registra. Todo lo que se descuenta del saldo de pruebas espera tu visto bueno.
--dry-run
¿Prefieres la terminal? Conéctate con dos comandos
Instala el binario y luego añade dna mcp serve a tu cliente MCP. Cada operación de la API se convierte en una herramienta para Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex CLI o 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@latestUn único binario sin dependencias. Cada versión se publica con sus sumas de verificación SHA-256.
- Una herramienta por cada operación de la API, cada una con un esquema JSON generado a partir de la especificación de la API
- dna_context le dice al modelo si está en producción o en el entorno de pruebas antes de que toque nada
- Expón solo lo que necesitas con --groups o --read-only. Una lista de herramientas más corta también ahorra tokens de contexto.
- Los agentes que solo tienen una shell reciben una skill de Claude Code y una guía de uso con una sola llamada
# conéctate primero al entorno de pruebas
$ claude mcp add dna -- dna mcp serve --env ote
# solo lectura, compartido con tu equipo mediante .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 de Claude Code: ~/.claude/skills/dna/SKILL.md
$ dna agent skill --install
# una guía compacta para las instrucciones de cualquier agente
$ dna agent guide Ejecuta dna mcp config para imprimir un fragmento listo para cada cliente.
Las 64 operaciones de la API, agrupadas como piensas tú
Si la API de revendedor puede hacerlo, dna también. El --help de cada comando muestra su clase de seguridad, su ruta de la API y ejemplos.
dna domain
Búsqueda simple y masiva, registro, renovación, transferencia y restauración. Bloqueo de transferencia, privacidad WHOIS, código de transferencia (auth), servidores de nombres, hosts hijos y redirección.
dna dns · dna dnssec
Registros de zona en los servidores de nombres de la plataforma y registros DS en el registro.
dna ssl
Genera un CSR, compra, configura, consulta el estado, descarga, reemite y revoca certificados.
dna hosting
Planes y paquetes de hosting, pedidos nuevos y su estado.
dna contact
Contactos reutilizables y la verificación de su correo electrónico y su teléfono.
dna account · product · order
Saldo y movimientos, el catálogo de extensiones con precios y el estado de los pedidos.
dna api
Una solicitud en bruto y autenticada a cualquier endpoint, con las mismas reglas de seguridad.
dna schema · enums · agent
Descripciones legibles por máquina de cada operación, entrada y valor codificado, para agentes y creadores de herramientas.
Hecho para pipes, tareas cron y pipelines
En una terminal obtienes tablas legibles. En una pipe, JSON. Los errores también son JSON, con códigos de salida que nunca cambian de significado, así que un script siempre sabe qué ha fallado.
- JSON al redirigir la salida, JSON Lines para flujos y un --jq integrado para recortar la salida
- Credenciales desde DNA_RESELLER_ID y DNA_API_KEY en CI, desde un perfil en tu propia máquina
- Sin preguntas ocultas fuera de una terminal: un comando protegido sale con el código 9 y no envía nada
- Las entradas se validan antes de enviar nada y, si se alcanza el límite de solicitudes, se reintenta por ti
# dominios que caducan en los próximos 30 días, en CSV
$ dna domain list --all \
--jq '.items[] | select(.remainingDay <= 30) | [.domainName, .expirationDate] | @csv'
# comprueba muchos nombres a la vez
$ dna domain bulk-search brand.com brand.net brand.io \
--jq '.infos[] | "\(.domainName)\t\(.status)\t\(.price)"'
# en un script, una compra sin --yes se detiene aquí
$ dna domain renew example.com --period 1
exit 9 confirmation required · nothing sent | 0 | éxito | 6 | límite de solicitudes |
|---|---|---|---|
| 2 | entrada no válida, no se envió nada | 7 | error del servidor |
| 3 | autenticación | 8 | red |
| 4 | no encontrado | 9 | requiere confirmación |
| 5 | rechazado por la API | 10 | modo solo lectura |
¿CLI, SDK, REST API o un módulo listo para usar?
Todos hablan con la misma API de revendedor y usan las mismas credenciales. Elige el que encaje con el lugar donde se hace el trabajo.
CLI y servidor MCP
Cuando el trabajo lo hace una persona, un script o un agente de IA: operaciones diarias, automatización, CI y asistentes como Claude o Cursor.
SDK
Cuando integras funciones de dominios en tu propia aplicación. PHP, Node.js, Python, Ruby y Go.
Ver los SDKREST API
Cuando quieres control total sobre cada solicitud, en cualquier lenguaje. JSON sobre HTTPS con dos cabeceras.
Lee la guía de la APIMódulos de facturación
Cuando vendes a través de WHMCS, Blesta, HostBill, WiseCP o Clientexec y quieres que todo funcione solo.
Ver las integracionesLo que se pregunta antes de conectar un agente
Respuestas breves y directas. El README de GitHub cubre todos los detalles.
Lee la documentación completa¿Qué es la CLI de Domain Name API?
dna es el cliente de línea de comandos y servidor MCP oficial de la plataforma de revendedores Domain Name API. Cubre las 64 operaciones de la REST API de revendedor, desde la búsqueda, el registro, la renovación y la transferencia de dominios hasta DNS, DNSSEC, contactos, SSL y hosting, en un único binario de código abierto para macOS, Linux y Windows con licencia Apache-2.0.
¿Es seguro dejar que un agente de IA registre dominios?
Sí, porque el agente no puede comprar nada por su cuenta. Las operaciones de pago y las destructivas devuelven una vista previa en lugar de ejecutarse. Solo se ejecutan cuando tú las apruebas y la llamada lleva confirm=true, o --yes en la CLI. Empieza con los agentes en el entorno de pruebas OTE y limítalos aún más con --read-only o --no-billable.
¿Puedo probarlo sin gastar dinero?
Sí. Con --env ote, dna se conecta a OTE, nuestro entorno de pruebas. Tiene su propia clave API y su propio saldo, y nada de lo que hagas allí afecta a dominios en producción ni a tu cuenta real.
¿Qué asistentes de IA funcionan con dna?
Cualquier cliente MCP: Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, OpenAI Codex CLI, Gemini CLI y otros. Los agentes que solo tienen una shell pueden llamar directamente a la CLI; dna agent guide y la skill de Claude Code les enseñan cómo.
¿Necesito una cuenta de Domain Name API?
Sí. dna funciona con una cuenta de revendedor y sus credenciales de API: tu ID de revendedor y una clave API, ambos en Ajustes de API dentro del panel de revendedor. Producción y OTE tienen claves distintas, y el correo y la contraseña de tu panel no sirven aquí.
¿dna es gratuito?
Sí. La herramienta es gratuita y de código abierto con licencia Apache-2.0. Solo pagas lo que compras a través de ella, como dominios, renovaciones, SSL y hosting, a tus precios de revendedor y con el saldo de tu cuenta.
¿Dónde se guardan mis credenciales?
dna auth login las guarda en un archivo de perfil dentro de la carpeta de configuración de tu usuario, que en Linux y macOS solo puedes leer tú; dna config path te dice dónde está. Las variables de entorno siempre tienen prioridad, y la clave API aparece enmascarada en todas las salidas, incluida la de --dry-run.
¿Puedo usar dna en scripts y CI?
Sí. La salida es JSON cuando se redirige, los errores son JSON con códigos de salida estables y no hay preguntas fuera de una terminal interactiva. Pasa las credenciales como DNA_RESELLER_ID y DNA_API_KEY. Un comando de pago sin --yes sale con el código 9 y no envía nada.
¿Uso la CLI o un SDK?
Usa dna cuando el trabajo lo hace una persona, un script o un agente de IA. Usa un SDK para PHP, Node.js, Python, Ruby o Go, o directamente la REST API, cuando integras funciones de dominios en tu propia aplicación. Todos usan la misma API y las mismas credenciales.
¿Tengo que usar la terminal?
No. Pega un prompt listo para usar en Claude Code, que también funciona en la aplicación de escritorio de Claude, o en ChatGPT Codex, y el asistente instala y conecta dna por ti. El único comando que escribes tú es dna auth login, así tu clave API nunca acaba en el chat. Si no tienes ninguna terminal, el prompt para chat te guía en cada paso.

