Nuevo · v1.0 · código abierto

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.

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
Con tus propias palabras

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 registerbillable

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

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

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

Pide 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 initializebillable

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

Control de seguridad

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.

  1. El agente pregunta primero

    Llama a la herramienta sin confirm. No se envía nada. Recibe una vista previa de la solicitud exacta.

  2. Tú decides

    El agente te muestra el dominio, el periodo y la operación. Tú dices sí o no.

  3. 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
Primeros pasos

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.

  1. Copia un prompt

    Elige Claude Code, ChatGPT Codex o el chat normal en la parte superior de esta página y copia el prompt.

  2. Pégalo en tu asistente

    El asistente instala dna, añade el servidor MCP y ejecuta dna doctor para comprobar la instalación.

    dna doctor
  3. Inicia 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 ote
  4. Pí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
Instalación manual

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

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

Ejecuta dna mcp config para imprimir un fragmento listo para cada cliente.

Cobertura

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.

Ver la referencia completa de comandos

Scripts y CI

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
Códigos de salida
0éxito6límite de solicitudes
2entrada no válida, no se envió nada7error del servidor
3autenticación8red
4no encontrado9requiere confirmación
5rechazado por la API10modo solo lectura
Elegir herramienta

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

Preguntas frecuentes

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