Entwickler & KI-Agenten

betadomain für KI-Agenten & Entwickler

Binde betadomain in Claude oder ChatGPT ein — oder rufe unsere öffentliche API direkt auf. Verfügbarkeit und Preise prüfen, nicht-personenbezogene WHOIS-Daten abfragen und — mit Token — eigene Domains verwalten. Alles ehrlich: Der Kauf braucht weiterhin einen menschlichen Checkout.

MCP-Endpunkt (Streamable HTTP · JSON-RPC 2.0)https://betadomain.de/api/mcp

betadomain in Claude hinzufügen →Als Connector im Claude-Verzeichnis verfügbar.

Schritt für Schritt

betadomain in Claude verbinden

Claude spricht über einen „Custom Connector" mit betadomain. Read-Tools funktionieren sofort; Bestell- und Konto-Tools brauchen einen Token (siehe unten).

Claude öffnen und zu Einstellungen → Connectors.
„Custom Connector hinzufügen" (teils „MCP-Server hinzufügen").
Als URL eintragen: https://betadomain.de/api/mcp und speichern.
Für Read-Tools bist du fertig — frag z. B. „Ist meinefirma.de bei betadomain frei?".
Für Write-Tools (Domains verwalten, Bestellung starten): im Portal einen Token erstellen und als Bearer-Token am Connector hinterlegen (Header Authorization: Bearer <token>).

Schritt für Schritt

betadomain in ChatGPT verbinden

Funktioniert analog über einen Custom Connector — sofern dein ChatGPT-Plan Custom Connectors/MCP unterstützt (z. B. Developer Mode oder Apps in Business-/Enterprise-Plänen). Fehlt die Option, bietet dein Plan sie (noch) nicht.

In ChatGPT zu Einstellungen → Connectors / Developer Mode.
Einen neuen Connector / MCP-Server hinzufügen.
Als URL eintragen: https://betadomain.de/api/mcp.
Für Write-Tools einen persönlichen Zugriffstoken als Bearer-Token eintragen (wie bei Claude).

Referenz

Verfügbare MCP-Tools

Read-Tools sind offen und pro IP ratenbegrenzt. Write-Tools erfordern einen Bearer-Token und arbeiten ausschließlich auf deinen eigenen Daten.

Tool	Was es tut	Beispiel-Eingabe	Token?
`domain_check`	Prüft eine vollständige Domain (inkl. Endung) auf Verfügbarkeit und liefert die Jahrespreise (Registrierung/Transfer/Verlängerung).	`{ "domain": "meinefirma.de" }`	nein
`domain_search`	Sucht einen Namen. Mit Endung wird genau diese geprüft, ohne Endung die beliebten Endungen (.de, .com, .eu, .net, .org, .shop, .io, .dev) parallel.	`{ "query": "meinefirma" }`	nein
`whois_lookup`	WHOIS/RDAP-Lookup. Liefert ausschließlich nicht-personenbezogene Registry-Felder: Status, Daten, Nameserver, Registrar — keine Inhaberdaten (DSGVO).	`{ "domain": "example.com" }`	nein
`list_tlds`	Listet die geführten Endungen mit Jahrespreisen. Optional category="popular", search="shop", limit/offset.	`{ "category": "popular" }`	nein
`tld_price`	Jahrespreise einer einzelnen Endung (Registrierung, Transfer, Verlängerung).	`{ "tld": ".io" }`	nein
`list_my_domains`	Listet die Domains des angemeldeten Kunden (Name, Endung, Status, Ablauf, Auto-Verlängerung) — nur eigene.	`{ }`	nötig
`start_order`	Startet eine Bestellung (Registrierung/Transfer). Prüft Verfügbarkeit und Preise serverseitig und liefert einen Stripe-Checkout-Link. Kein headless-Kauf.	`{ "items": [{ "domain": "meinefirma.de", "type": "register" }] }`	nötig
`get_order_status`	Fragt den Status einer eigenen Bestellung ab (Status, Betrag, Positionen, Datum).	`{ "orderId": "…" }`	nötig

Authentifizierung

Token erstellen

Write-Tools nutzen einen persönlichen Zugriffstoken (PAT). Im Portal erstellen, als Bearer-Token verwenden, jederzeit widerrufen.

Anmelden und betadomain.de/account/profile öffnen → Abschnitt „MCP-/API-Zugriff".
Auf „Token erstellen" klicken. Der Token (Präfix bdk_live_) wird genau einmal angezeigt — jetzt kopieren. Gespeichert wird nur ein SHA-256-Hash.
Als Header senden: Authorization: Bearer <token>.
Jeden Token im selben Bereich jederzeit widerrufen — Clients, die ihn nutzen, funktionieren sofort nicht mehr.

Bis zu 20 aktive Token pro Konto. Zum Erstellen ist ein Login nötig.

Direktzugriff

Öffentliche REST-API

Zwei lesende POST-Endpunkte — kein API-Key, keine Auth. Fair-Use: 30 Anfragen/Minute und 300/6 Stunden pro IP.

POST /api/domain/check

curl -X POST https://betadomain.de/api/domain/check \
  -H "Content-Type: application/json" \
  -d '{"domain":"meinefirma.de"}'

POST /api/domain/search

curl -X POST https://betadomain.de/api/domain/search \
  -H "Content-Type: application/json" \
  -d '{"query":"meinefirma"}'

Maschinenlesbare Beschreibung: /openapi.json (OpenAPI 3.1).

Maschinenlesbar

Discovery

Alles, was ein KI-System braucht, um unsere Schnittstellen zu finden und zu verstehen, liegt unter Well-Known-URLs.

/.well-known/mcp.jsonMCP Server Card — alle Fähigkeiten & Tools für Agenten
/.well-known/agent.jsonA2A Agent Card (Agent2Agent)
/.well-known/oauth-protected-resourceOAuth Protected-Resource-Metadaten (Bearer-Token)
/.well-known/oauth-authorization-serverOAuth-Authorization-Server (geplant, noch nicht aktiv)
/.well-known/api-catalogAPI-Katalog (RFC 9727 Linkset)
/.well-known/auth.mdHinweise für Agenten: was öffentlich geht, wo ein Mensch nötig ist
/openapi.jsonOpenAPI 3.1 der öffentlichen REST-API
/llms.txtKurzüberblick für KI-Systeme (llms.txt)
/llms-full.txtVolltext für KI-Systeme

Ehrliche Grenzen

Was Agenten nicht können

Kein headless-Kauf. start_order bereitet alles serverseitig vor und liefert einen Stripe-Checkout-Link — Zahlung und ggf. Identitätsprüfung (KYC) schließt ein Mensch ab. Es wird nichts automatisch belastet.
WHOIS liefert nur nicht-personenbezogene Registry-Felder (Status, Daten, Nameserver, Registrar) — keine Inhaber-, Admin- oder Tech-Kontakte (DSGVO). Bei .de liefert DENIC ohnehin nur eingeschränkt.
Preise und Verfügbarkeit werden immer serverseitig gegen unsere Live-Daten geprüft — nie aus Client-Eingaben übernommen.

Token erstellen MCP Server Card ansehen