MCP-сервер AgentDomains

MCP-сервер для AgentDomains — бесплатные домены для сайтов и API, которые создают AI-агенты. Он даёт любому MCP-совместимому агенту настоящее имя хоста в зоне makes.fyi или agentdomains.co, с DNS-записями, HTTPS, переадресацией URL и обратным проксированием.

Запускать можно двумя способами: локально через stdio с помощью npx либо подключившись к удалённой конечной точке https://mcp.agentdomains.co.

Установка (stdio)

Установка не требуется — npx загрузит пакет по запросу:

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 и другие клиенты с файлом конфигурации

Добавьте в claude_desktop_config.json (или аналогичный файл вашего клиента):

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

Related MCP server: domain-suite-mcp

Удалённая конечная точка

https://mcp.agentdomains.co

Streamable HTTP; отправляйте JSON-RPC через POST, передавая ключ в заголовке 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":{}}'

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

Конфигурация

Если вы уже используете Go CLI, его ~/.agentdomains/config.json подхватывается автоматически, и переменная окружения не нужна.

Ещё нет ключа? Вызовите инструмент signup — ему не нужны учётные данные, и он вернёт ключ. Кллюч показывается один раз и никогда не может быть восстановлен, поэтому сохраните его сразу. Аккаунты являются временными: прикрепите email с помощью attach_email и подтвердите его в течение 30 дней, иначе аккаунт и его домены будут удалены.

API-ключ никогда не логируется, не печатается и не включается в вывод ни одного инструмента.

Инструменты

Каждый инструмент, привязанный к метке, принимает необязательный параметр domain (makes.fyi, по умолчанию, или agentdomains.co). Отдельного API-эндпоинта для удаления DNS-записи нет.

Об HTTPS

«Получить SSL» здесь — не одна операция. Есть два честных пути:

• set_proxy — edge завершает TLS с помощью собственного сертификата и проксирует до вашего бэкенда. На исходном сервере ничего устанавливать не нужно.

• add_acme_challenge — публикует DNS-запись DNS-01 TXT, чтобы ваш собственный ACME-клиент мог выпустить сертификат Let's Encrypt (это нужно для wildcard-сертификатов или хостов без открытого внешнего порта 80). Обычный публичный веб-сервер может просто использовать HTTP-01 и вообще не нуждается в DNS-записи.

Совместимость

Работает с любым MCP-клиентом. Проверенные конфигурации для распространённых случаев:

• Claude Code — claude mcp add (stdio или --transport http), как указано выше.

• Claude Desktop — блок mcpServers в claude_desktop_config.json.

• OpenAI Agents SDK — MCPServerStdio(params={"command": "npx", "args": ["-y", "@agentdomains/mcp"]}) или MCPServerStreamableHttp для удалённого URL.

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

• CrewAI — MCPServerAdapter с теми же параметрами stdio.

• Всё остальное — направьте клиент на npx -y @agentdomains/mcp через stdio или на https://mcp.agentdomains.co через Streamable HTTP.

Разработка

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

Требуется Node 18+. Единственная зависимость во время выполнения — @modelcontextprotocol/sdk.

Связанные проекты

• CLI (Go) — команда agentdomains

• Agent skill — плагин для Claude Code

• Документация · HTTP API

Лицензия

FSL-1.1-Apache-2.0 — см. LICENSE. Те же условия, что и для CLI.