Servidor MCP de AgentDomains

Servidor MCP para AgentDomains: dominios gratuitos para los sitios web y las APIs que crean los agentes de IA. Proporciona a cualquier agente compatible con MCP un hostname real bajo makes.fyi o agentdomains.co, con registros DNS, HTTPS, reenvío de URLs y proxy inverso.

Dos formas de ejecutarlo: localmente vía stdio con npx, o contra el endpoint remoto alojado en https://mcp.agentdomains.co.

Instalación (stdio)

No hay paso de instalación — npx lo descarga bajo demanda:

AGENTDOMAINS_API_KEY=adom_… npx -y @agentdomains/mcp

Claude Code

claude mcp add agentdomains --env AGENTDOMAINS_API_KEY=adom_… -- npx -y @agentdomains/mcp

Claude Desktop y otros clientes con archivo de configuración

Añádelo a claude_desktop_config.json (o el equivalente de tu cliente):

{
  "mcpServers": {
    "agentdomains": {
      "command": "npx",
      "args": ["-y", "@agentdomains/mcp"],
      "env": { "AGENTDOMAINS_API_KEY": "adom_…" }
    }
  }
}

Related MCP server: domain-suite-mcp

Endpoint remoto

https://mcp.agentdomains.co

Streamable HTTP; envía JSON-RPC mediante POST con tu clave en la cabecera Authorization:

curl -s https://mcp.agentdomains.co \
  -H 'Authorization: Bearer adom_…' \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

En Claude Code: claude mcp add --transport http agentdomains https://mcp.agentdomains.co --header "Authorization: Bearer adom_…"

Configuración

Si ya usas la CLI de Go, su ~/.agentdomains/config.json se utiliza automáticamente y no necesitas ninguna variable de entorno.

¿Aún no tienes clave? Llama a la herramienta signup — no requiere credenciales y devuelve una. La clave se muestra una sola vez y nunca se puede recuperar, así que guárdala inmediatamente. Las cuentas son provisionales: asocia un correo con attach_email y confírmalo en un plazo de 30 días, o la cuenta y sus dominios se eliminarán.

La clave de API nunca se registra en los logs, ni se imprime, ni se incluye en la salida de ninguna herramienta.

Herramientas

Toda herramienta asociada a un dominio incluye un domain opcional (makes.fyi, el valor por defecto, o agentdomains.co). No hay ningún endpoint para eliminar un registro DNS individual.

Sobre HTTPS

«Get me SSL» no es una sola operación aquí. Hay dos caminos honestos:

• set_proxy — el borde pone fin TLS con su propio certificado y hace de proxy hacia tu backend; nada que instalar en el origen.

• add_acme_challenge — publica el registro TXT DNS-01 para que tu propio cliente ACME pueda emitir un certificado Let's Encrypt (necesario para comodines o hosts sin el puerto público 80). Un servidor web público normal puede usar simplemente HTTP-01 y no necesita ningún registro DNS.

Compatibilidad

Cualquier cliente MCP funciona. Estas son las formas verificadas para los más comunes:

• Claude Code — claude mcp add (stdio o --transport http), como arriba.

• Claude Desktop — bloque mcpServers en claude_desktop_config.json.

• OpenAI Agents SDK — MCPServerStdio(params={"command": "npx", "args": ["-y", "@agentdomains/mcp"]}), o MCPServerStreamableHttp contra https://mcp.agentdomains.co.

• LangChain / LangGraph — langchain-mcp-adapters: MultiServerMCPClient({"agentdomains": {"command": "npx", "args": ["-y", "@agentdomains/mcp"], "transport": "stdio"}}).

• CrewAI — MCPServerAdapter con los mismos parámetros de stdio.

• Cualquier otro — apunta tu cliente a npx -y @agentdomains/mcp por stdio, o a https://mcp.agentdomains.co por Streamable HTTP.

Desarrollo

npm install
npm run build     # tsc -> dist/
npm run smoke     # boots dist/index.js, runs initialize + tools/list over stdio

Requiere Node.js 18+. La única dependencia en tiempo de ejecución es @modelcontextprotocol/sdk.

Relacionados

• CLI (Go) — el comando agentdomains

• Agent skill — plugin de Claude Code

• Docs · API HTTP

Licencia

FSL-1.1-Apache-2.0 — consulta LICENSE. Los mismos términos que la CLI.