AgentDomains MCP-Server

MCP-Server für AgentDomains — kostenlose Domains für die Websites und APIs, die KI-Agenten erstellen. Er gibt jedem MCP-fähigen Agenten einen echten Hostnamen unter makes.fyi oder agentdomains.co, mit DNS-Einträgen, HTTPS, URL-Weiterleitung und Reverse-Proxying.

Es gibt zwei Möglichkeiten, ihn auszuführen: über stdio lokal mit npx oder über den gehosteten Remote-Endpunkt https://mcp.agentdomains.co.

Installation (stdio)

Kein Installationsschritt — npx lädt ihn bei Bedarf herunter:

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 und andere Clients mit Konfigurationsdatei

Fügen Sie den Eintrag in claude_desktop_config.json (oder die entsprechende Datei Ihres Clients) ein:

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

Related MCP server: domain-suite-mcp

Remote-Endpunkt

https://mcp.agentdomains.co

Streamable HTTP; senden Sie JSON-RPC per POST mit Ihrem Schlüssel im Authorization-Header:

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":{}}'

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

Konfiguration

Wenn Sie bereits die Go CLI verwenden, wird deren ~/.agentdomains/config.json automatisch übernommen; eine Umgebungsvariable ist dann nicht erforderlich.

Noch keinen Schlüssel? Rufen Sie das signup-Tool auf — es benötigt keinerlei Anmeldeinformationen und gibt einen Schlüssel zurück. Der Schlüssel wird nur einmal angezeigt und kann nie wieder abgerufen werden, sichern Sie ihn also sofort. Konten sind vorläufig: Fügen Sie mit attach_email eine E-Mail-Adresse hinzu und bestätigen Sie sie innerhalb von 30 Tagen, andernfalls werden das Konto und seine Domains gelöscht.

Der API-Schlüssel wird nie protokolliert, ausgegeben oder in eine Tool-Ausgabe aufgenommen.

Tools

Jedes Tool mit einem Label akzeptiert eine optionale domain (makes.fyi, der Standard, oder agentdomains.co). Es gibt keinen Endpunkt, um einen einzelnen DNS-Eintrag zu löschen.

Über HTTPS

„Besorg mir SSL“ ist hier kein einzelner Vorgang. Stattdessen gibt es zwei ehrliche Wege:

• set_proxy — die Edge übernimmt die TLS-Terminierung mit einem eigenen Zertifikat und leitet an Ihr Backend weiter. Auf dem Ursprungsserver muss nichts installiert werden.

• add_acme_challenge — veröffentlicht den DNS-01-TXT-Eintrag, damit Ihr eigener ACME-Client ein Let's-Encrypt-Zertifikat ausstellen kann (erforderlich für Wildcards oder Hosts ohne öffentlichen Port 80). Ein normaler öffentlicher Webserver kann einfach HTTP-01 verwenden und braucht überhaupt keinen DNS-Eintrag.

Kompatibilität

Jeder MCP-Client funktioniert. Verifizierte Konfigurationen für die gängigen Clients:

• Claude Code — claude mcp add (stdio oder --transport http), wie oben.

• Claude Desktop — mcpServers-Block in claude_desktop_config.json.

• OpenAI Agents SDK — MCPServerStdio(params={"command": "npx", "args": ["-y", "@agentdomains/mcp"]}) oder MCPServerStreamableHttp gegen die Remote-URL.

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

• CrewAI — MCPServerAdapter mit denselben Stdio-Parametern.

• Sonstiges — richten Sie Ihren Client per stdio auf npx -y @agentdomains/mcp aus oder über Streamable HTTP auf https://mcp.agentdomains.co.

Entwicklung

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

Erfordert Node 18+. Die einzige Laufzeitabhängigkeit ist @modelcontextprotocol/sdk.

Verwandtes

• CLI (Go) — der Befehl agentdomains

• Agent skill — Plugin für Claude Code

• Dokumentation · HTTP-API

Lizenz

FSL-1.1-Apache-2.0 — siehe LICENSE. Gleiche Bedingungen wie die CLI.