Namefi

Namefi-MCP-Server: Domain-Tools für KI-Agenten

Jedes Tool, das der Namefi-MCP-Server KI-Agenten bereitstellt: Suche, Registrierung, DNS, Verlängerungen, Tokenisierung sowie das Authentifizierungsmodell und Beispielabläufe.

Aileen WrightAileen WrightAutor*inVictor ZhouVictor ZhouRedaktionKai KunstmannKai KunstmannÜbersetzung10. Juli 2026ca. 10 Min. Lesezeit
  • ai-agents
  • domains
  • web3
Auf X teilen

Jeder KI-Agent, der sich mit dem Namefi-MCP-Server verbindet, sieht dieselbe Liste aufrufbarer Tools — eines für jede von der API definierte Operation. Sie decken Suche, Registrierung, DNS, Domain-Konfiguration, Outbound-Lead-Findung und Zahlung ab. Diese Seite ist der Katalog: jedes Tool, seine Funktion, seine erforderliche Authentifizierung sowie drei ausgearbeitete Beispiele, die mehrere Tools zu einem echten Workflow kombinieren.

Wenn Sie noch keinen Agenten mit Namefi verbunden haben, beginnen Sie mit Eine Domain mit Ihrem KI-Agenten bei Namefi registrieren für die Einrichtung je Client oder Eine Domain mit Claude kaufen: Schritt-für-Schritt-Anleitung für Namefi MCP für ein vollständiges Transkript. Diese Seite setzt voraus, dass die Verbindung bereits besteht.

Was der Namefi-MCP-Server ist

Namefi betreibt für seine gesamte API einen einzigen MCP-Server unter https://api.namefi.io/mcp über den Streamable-HTTP-Transport. Statt dass ein Agent REST-Aufrufe aus in einen Chat kopierter Dokumentation von Hand zusammensetzt, verbindet er sich einmal und erhält für jede von der API definierte Operation ein typisiertes Tool. Diese werden direkt aus Namefis eigener OpenAPI-3-Spezifikation unter api.namefi.io/v-next/openapi/doc.json generiert, sodass MCP-Katalog und REST-API nicht auseinanderlaufen können.

Ein maschinenlesbarer Discovery-Deskriptor unter namefi.io/.well-known/mcp/servers.json ermöglicht einem Agenten, den Server zu finden, ohne dass ein Mensch eine URL manuell in eine Konfigurationsdatei einfügt: Er nennt den Server namefi-api, meldet den Transport streamable-http und erklärt apiKey/x-api-key zur Verbindungs-Authentifizierung. Namefi, ein von ICANN akkreditierter Registrar, veröffentlicht dieselben Operationen außerdem als einfache HTTPS-Endpunkte unter namefi.io/llms.txt, für Agenten und Skripte, die kein MCP sprechen.

Der vollständige Funktionskatalog

Im Folgenden stehen alle zum Veröffentlichungszeitpunkt von der API definierten Operationen, gruppiert wie in Namefis eigener Referenz. Die Spalte Operation enthält die operationId aus der OpenAPI-Spezifikation — den Namen, aus dem die Tool-Liste eines MCP-Clients aufgebaut wird. Die Spalte Authentifizierung zeigt den einfachsten Weg (ein API-Schlüssel deckt fast alles ab); das vollständige Authentifizierungsmodell einschließlich der Alternativen zum API-Schlüssel folgt im nächsten Abschnitt.

Suche und Discovery

OperationEndpunktFunktionAuthentifizierung
checkAvailabilityGET /v-next/search/availabilityPrüft, ob ein einzelner Domainname zur Registrierung frei istKeine
checkBulkAvailabilityGET /v-next/search/bulk-availabilityPrüft in einem Aufruf einen Stapel möglicher NamenKeine
getSuggestionsGET /v-next/search/suggestionsLiefert algorithmische Namensvorschläge zu einer SuchanfrageKeine

Registrierung und Bestellungen

OperationEndpunktFunktionAuthentifizierung
registerDomainPOST /v-next/orders/register-domainRegistriert eine Domain für 0–10 Jahre. Akzeptiert ein Objekt domainSetupOptions (autoPark, autoEns, autoRenew, dnssec, keepExistingNameservers) und optional nftReceivingWalletAPI-Schlüssel
registerWithRecordsPOST /v-next/orders/register-domain/recordsRegistriert eine Domain und legt im selben Aufruf einen ersten Satz DNS-Einträge anAPI-Schlüssel
getOrderGET /v-next/orders/{orderId}Fragt eine Bestellung ab, bis sie einen endgültigen Status erreicht: SUCCEEDED, FAILED, CANCELLED oder PARTIALLY_COMPLETEDAPI-Schlüssel

Die Registrierung erfolgt asynchron: registerDomain gibt sofort eine Bestell-id zurück, und der Agent fragt getOrder ab, bis die Bestellung abgeschlossen ist. Sowohl die Claude-Anleitung als auch der Einrichtungsleitfaden für mehrere Agenten zeigen dieses Muster als vollständiges Transkript.

Verwaltung von DNS-Einträgen

Vollständiges CRUD, einzeln oder im Batch, plus ein Lesezugriff, der überhaupt keine Authentifizierung benötigt:

OperationEndpunktFunktionAuthentifizierung
getDnsRecordsGET /v-next/dns/recordsListet jeden Eintrag in einer Zone aufKeine
createDnsRecordPOST /v-next/dns/recordsErstellt einen EintragAPI-Schlüssel
updateDnsRecordPUT /v-next/dns/recordAktualisiert einen Eintrag anhand seiner IDAPI-Schlüssel
deleteDnsRecordDELETE /v-next/dns/recordLöscht einen Eintrag anhand seiner IDAPI-Schlüssel
batchCreateDnsRecordsPOST /v-next/dns/records/batchErstellt viele Einträge in einem AufrufAPI-Schlüssel
batchUpdateDnsRecordsPUT /v-next/dns/records/batchAktualisiert viele Einträge in einem AufrufAPI-Schlüssel
batchDeleteDnsRecordsDELETE /v-next/dns/records/batchLöscht viele Einträge in einem AufrufAPI-Schlüssel

Unterstützte Eintragstypen: A, AAAA, CNAME, MX, TXT, NS, SOA, PTR, SRV, CAA, DS, TLSA, SSHFP, HTTPS, SVCB, NAPTR, SPF. Zwei Formatierungsregeln bringen die meisten ersten Versuche zu Fall: zoneName darf keinen abschließenden Punkt haben; rdata-Werte für CNAME-, MX- und NS-Einträge müssen einen haben.

Umschalter auf Domain-Ebene

Diese schalten eine vollständige Funktion ein oder aus und sind von einem einzelnen DNS-Eintrag zu unterscheiden:

OperationEndpunktFunktionAuthentifizierung
toggleDomainParking / parkDomainPUT / POST /v-next/dns/parkSchaltet Domain-Parking ein oder ausAPI-Schlüssel
isDomainParkedGET /v-next/dns/parkedPrüft, ob eine Domain derzeit geparkt istKeine
toggleForwardingPUT /v-next/dns/forwardingSchaltet Domain-Weiterleitung ein oder ausAPI-Schlüssel
toggleAutoEnsPUT /v-next/dns/auto-ensSchaltet die automatische Veröffentlichung von ENS-Einträgen ein oder ausAPI-Schlüssel
toggleVercelAnyCastRecordsPUT /v-next/dns/vercel-anycastSchaltet Vercel-Anycast-DNS-Einträge ein oder ausAPI-Schlüssel

Beachten Sie, dass DNSSEC nicht zu diesen Umschaltern gehört: Es wird bei der Registrierung gesetzt, als eines der oben genannten domainSetupOptions-Felder von registerDomain, nicht über einen separaten Endpunkt, den ein Agent anschließend aufruft.

Domain-Konfiguration

OperationEndpunktFunktionAuthentifizierung
getAutoRenewGET /v-next/domain-config/auto-renewPrüft, ob die automatische Verlängerung aktiviert istAPI-Schlüssel
toggleAutoRenewPUT /v-next/domain-config/auto-renewSchaltet die automatische Verlängerung ein oder ausAPI-Schlüssel

Wenn die automatische Verlängerung aktiv ist, verlängert sich die Domain vor Ablauf automatisch mit den in der Eigentümer-Wallet hinterlegten Zahlungsarten. Das ist eine fortlaufende Autorisierung, die Sie bewusst für jede Domain entscheiden sollten, statt sie standardmäßig für ein ganzes Portfolio aktiviert zu lassen.

Outbound-Lead-Findung

Die neueste Oberfläche verwandelt gehaltene Domains aus einer statischen Asset-Liste in eine Vertriebspipeline:

OperationEndpunktFunktionAuthentifizierung
getUserDomainsGET /v-next/user/domainsListet Domains auf, die der authentifizierten Wallet gehörenAPI-Schlüssel
startOutboundRunPOST /v-next/outbound/runsStartet für eine gehaltene Domain einen KI-Lead-Finding-Lauf mit reasoningEffort von low, medium oder highAPI-Schlüssel
listOutboundRunsGET /v-next/outbound/runsListet vergangene und aktive Läufe aufAPI-Schlüssel
getOutboundRunGET /v-next/outbound/runs/{runId}Fragt den Status eines Laufs ab: QUEUED, RUNNING, SUCCEEDED, FAILED oder CANCELEDAPI-Schlüssel
listOutboundLeadsGET /v-next/outbound/runs/{runId}/leadsListet priorisierte Käufer-Leads auf, jeweils mit Begründung, gefundenen Kontakten und vorhandenem Outreach-EntwurfAPI-Schlüssel
prepareOutboundOutreachPOST /v-next/outbound/runs/{runId}/leads/{leadId}/outreachErzeugt für einen Lead einen Outreach-Entwurf oder gibt den bestehenden ohne zusätzliche Generierungskosten zurückAPI-Schlüssel

Die Antwort lässt interne Ranking-Mechanismen aus — Score, Modelldetails und Status unterdrückter Leads. Ein Agent, der Ergebnisse für einen Menschen zusammenfasst, sieht daher nur die öffentliche Begründung, den gefundenen Kontakt und ob ein Entwurf existiert.

Zahlungen und Konto

OperationEndpunktFunktionAuthentifizierung
getBalanceGET /v-next/balancePrüft das NFSC-Guthaben (Namefi Service Credit), das Registrierungen finanziertAPI-Schlüssel
requestNfscFaucetPOST /v-next/user/faucetFordert kostenlose NFSC-Testguthaben an (nur Entwicklungsumgebungen)API-Schlüssel
registerDomainX402GET /x402/domain/{domainName}Registriert und bezahlt in einem Stablecoin-signierten HTTP-402-Ablauf, ohne Namefi-KontoWallet-Signatur
GET /x402/purchase/{purchaseId}Fragt den Status eines x402-Kaufs abKeine
registerDomainMPPGET /mpp/domain/{domainName}Registriert und bezahlt über den Challenge-Response-Ablauf des MPP (Machine Payable Protocol)Wallet-Signatur

Damit sind alle Operationen für Suche, Registrierung, DNS, Domainkonfiguration, Outbound und Zahlung abgedeckt — jede ist über die einzelne Serververbindung als MCP-Tool oder als einfacher HTTPS-Aufruf für Agenten erreichbar, die kein MCP sprechen. (Namefis API stellt außerhalb dieser Liste auch einige Hilfsoperationen für Kontoverwaltung und EIP-712/SIWE bereit; den stets aktuellen vollständigen Satz finden Sie in der unten verlinkten OpenAPI-Spezifikation.)

Das Authentifizierungsmodell: drei Zugangswege, eine Wallet dahinter

Jede obige Schreiboperation prüft über einen von drei Wegen dasselbe: Kontrolliert der Aufrufer die Wallet, die die Domain besitzt oder besitzen wird? Welcher Weg gilt, hängt von der Operation ab, nicht von einer einzelnen Einstellung auf Kontoebene.

API-Schlüssel (x-api-key). Die einfachste Option und diejenige, die jedes ausgearbeitete Beispiel in diesem Cluster verwendet. Erzeugen Sie einen Schlüssel unter namefi.io/api-key. Er funktioniert für jede obige Operation, einschließlich DNS-Schreibvorgängen, Parking und Registrierung, weil der Schlüssel die Berechtigungen der Wallet übernimmt, die ihn erzeugt hat. Übergeben Sie ihn als einfachen HTTP-Header; ein SDK ist nicht erforderlich.

EIP-712-Signatur typisierter Daten. Für den programmatischen Einsatz ohne gespeicherten Schlüssel signieren Sie jede Anfrage mit einer Ethereum-Wallet: Die Header x-namefi-signer, x-namefi-signature und x-namefi-eip712-type verpacken den Payload mit Zeitstempel und einmaligem Nonce, der nach 300 Sekunden abläuft. So führen Sie Operationen wie toggleDomainParking, createDnsRecord und registerDomain ohne API-Schlüssel aus. Domain und Typdefinitionen kommen von Live-Endpunkten (GET /v-next/eip712/domain, /eip712/types) und nicht aus einer hartcodierten Konstante, da die Namefi-Dokumentation darauf hinweist, dass sie sich ändern können. Smart-Contract-Wallets können nicht direkt signieren; daher signiert ein zugelassenes externes Konto im Namen des Contracts, während x-namefi-erc1271-account oder x-namefi-eip7702-account den Contract benennen, der die Anfrage autorisiert.

SIWE (Sign-In with Ethereum). Ein Session-Token (x-namefi-siwe-token) für geschützte Lesezugriffe, die nicht bei jedem Aufruf eine neue Signatur benötigen, etwa das Auflisten gehaltener Domains oder Bestellungen: Nonce abrufen, zu signierende Nachricht abrufen, mit personal_sign signieren, verifizieren und den Token dann wiederverwenden.

Eine Handvoll Operationen benötigen keine Authentifizierung — checkAvailability, getSuggestions, getDnsRecords, isDomainParked und die EIP-712-Metadatenendpunkte —, weil sie schreibgeschützt sind und nichts offenlegen, was das öffentliche DNS einer Domain nicht ohnehin in einem Browser zeigen würde.

Darüber liegt die Zahlung. registerDomainX402 wickelt einen Kauf über das x402-Protokoll ab: Die Wallet des Käufers signiert eine EIP-3009-transferWithAuthorization für einen Stablecoin wie USDC, ohne dass ein Namefi-Konto beteiligt ist. registerDomainMPP erreicht dasselbe Ergebnis stattdessen über einen signierten Challenge-Response. Beide erlauben es einem Agenten, die Kontoerstellung zu überspringen und pro Transaktion zu zahlen — Domains mit einer Krypto-Wallet bezahlen: Kein Konto nötig beschreibt diesen Weg vollständig.

Die Tokenisierung läuft durch den Katalog, nicht daneben

registerDomain mintet die Domain standardmäßig auf Base als NFT — einen ERC-721-Token, die Standardschnittstelle, die die meisten Marktplätze und Wallets bereits lesen — für die Wallet, die an den API-Schlüssel des Aufrufers gebunden ist. nftReceivingWallet leitet das bei der Registrierung an eine andere Wallet oder Chain weiter, und alles danach — DNS-Schreibvorgänge, Parking, automatische Verlängerung, Outbound-Lead-Findung — prüft denselben On-Chain-Eigentumsnachweis statt einer separaten Kontodatenbank. Eine auf einem Marktplatz wie OpenSea gehandelte tokenisierte Domain trägt DNS-Kontrolle und ERC-721-Eigentümerschaft als ein Objekt, nicht als zwei Systeme, die man von Hand synchron halten muss.

Drei Agenten, drei Wege, dasselbe Toolset zu nutzen

Ein Builder registriert eine Domain und stellt DNS in einem Gespräch bereit. checkAvailability bestätigt, dass der Name frei ist; registerDomain übermittelt ihn mit domainSetupOptions, die für autoRenew und dnssec gesetzt sind; und sobald die Bestellung SUCCEEDED erreicht, schreibt batchCreateDnsRecords die CNAME- und TXT-Einträge, auf die der Verifizierungsschritt einer Deployment-Plattform wartet. Der Namefi-MCP-Quickstart für Programmieragenten führt durch diese Abfolge in einem Editor.

Ein Domain-Händler verwaltet ein Portfolio. getUserDomains lädt die aktuellen Bestände, checkBulkAvailability prüft neue Kandidaten in einem Aufruf und registerDomain nimmt die kaufwürdigen Namen auf. Für weiterverkaufte Namen stellt toggleDomainParking eine Landingpage bereit und isDomainParked bestätigt, dass sie live ist; im gesamten Portfolio entscheiden getAutoRenew und toggleAutoRenew, welche Namen eine fortlaufende Verlängerungsautorisierung wert sind und welche spekulativ genug sind, um sie auslaufen zu lassen.

Ein Unternehmen betreibt Outbound-Lead-Findung für bereits gehaltene Namen. getUserDomains identifiziert eine ungenutzte Domain, startOutboundRun startet die Recherche und getOutboundRun fragt ab, bis der Lauf SUCCEEDED erreicht. listOutboundLeads liefert priorisierte Unternehmen, deren Profil darauf hinweist, dass sie den Namen wünschen könnten, und prepareOutboundOutreach entwirft eine E-Mail pro Lead — einmal erzeugt und bei wiederholten Aufrufen kostenlos zurückgegeben.

Bevor ein Agent all dies unbeaufsichtigt ausführt

Namefis eigene Outbound-Dokumentation kennzeichnet vier Operationen als folgenreichregisterDomain, registerWithRecords, startOutboundRun, prepareOutboundOutreach —, weil jede Guthaben ausgibt oder eine nach außen sichtbare Handlung ausführt. Schreibgeschützte Tools wie checkAvailability lassen sich risikolos autonom ausführen; alles, was eine Bestellung, einen DNS-Eintrag auf einer Live-Domain oder einen Outreach-Entwurf schreibt, verdient einen Bestätigungsschritt. Was ist ein agent-nativer Domain-Registrar? bietet eine ausführlichere Checkliste, um die Agentenschnittstelle jedes Registrars so zu bewerten.

Diesen Katalog aktuell halten

Diese Tabelle spiegelt Namefis Live-OpenAPI-Spezifikation zum oben genannten Veröffentlichungsdatum wider, keine feste Roadmap. Neue Operationen erscheinen in namefi.io/llms.txt und namefi.io/llms-full.txt, bevor sie in einer Tabelle eines Blogbeitrags landen.

Häufig gestellte Fragen

Brauche ich einen API-Schlüssel, nur um zu prüfen, ob ein Name verfügbar ist?

Nein. checkAvailability, checkBulkAvailability und getSuggestions benötigen keine Authentifizierung und funktionieren daher gegen einen frisch verbundenen Agenten, bevor irgendein Guthaben aufgeladen ist.

Kann ein Agent diesen gesamten Katalog nutzen, ohne dass ich jemals einen Namefi-API-Schlüssel halte?

Ja. registerDomainX402 und registerDomainMPP wickeln beide eine Registrierung über eine Wallet-Signatur ohne Namefi-Konto ab, und die EIP-712-Signatur deckt die übrigen Schreiboperationen direkt aus einer Wallet.

Wird eine Domain automatisch tokenisiert, wenn ich sie über einen dieser Wege registriere?

Ja, standardmäßig über jeden Registrierungsweg. Wenn nftReceivingWallet nicht angegeben ist, wird die Domain auf Base als ERC-721-NFT für die an den API-Schlüssel des Aufrufers gebundene Wallet registriert.

Welche Operationen sollte ein Mensch bestätigen, bevor ein autonomer Agent sie ausführt?

Mindestens die vier in Namefis Dokumentation als folgenreich markierten — registerDomain, registerWithRecords, startOutboundRun, prepareOutboundOutreach — sowie jeden DNS-Schreibvorgang auf einer Domain, die bereits Live-Traffic bedient.

Verbinden Sie Ihren Agenten mit dem vollständigen Katalog

Jedes obige Tool ist über eine Verbindung live: https://api.namefi.io/mcp. Falls Sie diese noch nicht eingerichtet haben, erläutert Eine Domain mit Ihrem KI-Agenten bei Namefi registrieren die genaue Konfiguration für sechs verschiedene Clients, und llms.txt für Domains erklärt die darunterliegende Discovery-Schicht.

Einen Namefi-API-Schlüssel erzeugen und Ihren Agenten auf den Server richten — dort warten die oben genannten Tools auf ihn.

Quellen und weiterführende Lektüre

Mitwirkende

Aileen Wright
Autorin für Kunst und Geschichte • Namefi

Aileen Wright ist eine Studentin in ihren Zwanzigern und lebt in New York City — an einem Ort, an dem zwischen einer Museumswand und dem Lesesaal einer Bibliothek nur ein kurzer Spaziergang und ein langer Nachmittag liegen. Zum Schreiben über Namen kam sie über Kunst und Geschichte: über die Art, wie ein einzelnes Porträt, eine Münze oder eine Randnotiz in einem Manuskript einen Namen durch die Jahrhunderte tragen und dabei seine Bedeutung verändern kann.

In den meisten Wochen findet man sie mit einem Taschenbuch im Central Park oder in der Stille eines öffentlichen Lesesaals, wo sie der tatsächlichen Herkunft eines Namens nachgeht, statt sich mit der Bedeutung aus einer Namensliste zufriedenzugeben. Außerdem bringt sie sich selbst das Programmieren bei, was sie ungewöhnlich genau auf Rechtschreibung, Sortierung und jene kleinen Details achten lässt, die darüber entscheiden, ob ein Name gut altert.

Für Namefi schreibt sie über die Geschichte und Kultur hinter Domainnamen, über die Geschichten, die Marken bei einer Umbenennung mit sich tragen, und über den Unterschied zwischen einer guten Geschichte und einer verifizierten Quelle.

Victor Zhou
Victor ZhouRedaktion
Gründer und Redakteur für technische Standards • Namefi

Victor Zhou ist Technologiegründer und Redakteur für technische Standards mit dem Schwerpunkt auf digitaler Identität und Vertrauen. Er gründete Namefi, redigiert Ethereum Improvement Proposals und leitete zuvor bei Google Labs die Arbeit an Smart-Contract-Architekturen.

Seine Arbeit liegt an der Schnittstelle von Namensgebung, Eigentum und den Systemen, mit denen Menschen ihre Identität online nachweisen. Diese Perspektive weckt sein besonderes Interesse daran, wie Namen zwischen persönlicher Bedeutung, öffentlicher Wiedererkennung und digitaler Infrastruktur wandern.

Für Namefi redigiert und schreibt Victor über Domains als dauerhafte digitale Identität: darüber, wie Namen zu besitzbaren Onchain-Assets werden, wie Tokenisierung Verwahrung und Vertrauen verändert und was Namensgebung von den Systemen lernen kann, mit denen Menschen ihre Identität online nachweisen.

Kai Kunstmann
Kai KunstmannÜbersetzung
Übersetzer für deutsche Lokalisierung • Namefi

Kai Kunstmann ist ein technischer Übersetzer Mitte dreißig und lebt in Leipzig. Er absolvierte eine Ausbildung zum Mechatroniker in einem mittelständischen Maschinenbauunternehmen und schrieb und übersetzte jahrelang Maschinenhandbücher, bevor er zur Lokalisierung von Software und redaktionellen Inhalten zwischen Englisch und Deutsch wechselte.

Er arbeitet mit der Präzision eines guten Handbuchs: einheitliche Terminologie, keine falschen Freunde und zusammengesetzte Wörter, die ein deutscher Leser auf Anhieb versteht. Er pflegt einen Schrebergarten, restauriert alte Fahrräder und braut sein eigenes Bier — Hobbys, bei denen es sich auszahlt, vor dem Schneiden genau zu messen.

Für Namefi lokalisiert er Texte über Domains und Namensgebung ins Deutsche. Er achtet besonders auf den Umgang mit IDNs und Umlauten (ä→ae), den Unterschied zwischen .de und .eu sowie auf Markennamen, die aus den langen Zusammensetzungen entstehen, die im Deutschen so gut funktionieren.

Verwandte Leitfäden

Diskutiere diesen Beitrag

Diskussion auf Namefi Discuss ansehen