Namefi MCPサーバー：AIエージェント向けドメインツール

Namefi MCPサーバーへ接続するすべてのAIエージェントには、同じ呼び出し可能なツール一覧が表示されます。APIが定義する各操作に一つずつ用意され、検索、登録、DNS、ドメイン単位の設定、アウトバウンドリード発掘、決済を網羅しています。このページは全体のカタログです。すべてのツール、その機能、必要な認証、複数のツールを実際のワークフローに組み合わせる三つの実例を紹介します。

まだエージェントをNamefiへ接続していない場合は、クライアント別の設定を説明するNamefiでAIエージェントを使ってドメインを登録する方法か、対話記録全体を掲載したClaudeでドメインを購入する：Namefi MCPステップ別ガイドから始めてください。このページでは接続がすでに存在すると仮定します。

Namefi MCPサーバーとは

NamefiはAPI全体に対応する単一のMCPサーバーを、https://api.namefi.io/mcpでStreamable HTTP転送方式により運用しています。エージェントがチャットに貼り付けられたドキュメントを基にREST呼び出しを一つずつ自作するのではなく、一度接続するとAPIが定義するすべての操作に対応した型付きツールを受け取ります。これらはNamefi自身のOpenAPI 3仕様であるapi.namefi.io/v-next/openapi/doc.jsonから直接生成されるため、MCPカタログとREST APIが食い違うことはありません。

namefi.io/.well-known/mcp/servers.jsonにある機械可読ディスカバリーディスクリプターを使うと、人間が設定ファイルへURLを手で貼り付けなくてもエージェントがサーバーを見つけられます。サーバー名はnamefi-api、転送方式はstreamable-http、接続認証はapiKey/x-api-keyと記載されています。ICANN認定レジストラのNamefiは、MCPを利用しないエージェントやスクリプト向けに、同じ操作を通常のHTTPSエンドポイントとしてnamefi.io/llms.txtでも公開しています。

完全な機能カタログ

以下は、この執筆時点でAPIが定義するすべての操作を、Namefi自身のリファレンスと同じ分類でまとめたものです。操作列はOpenAPI仕様のoperationId、つまりMCPクライアントのツール一覧で使われる名前です。認証列は最も簡単な方法を示します。APIキーでほぼすべてを扱えます。APIキー以外の選択肢を含む完全な認証モデルは、次のセクションで説明します。

検索と発見

登録と注文

登録は非同期です。registerDomainは注文のidをすぐに返し、エージェントは完了するまでgetOrderをポーリングします。Claudeガイドと複数エージェントの設定ガイドでは、どちらも対話記録全体を通じてこのパターンを示しています。

DNSレコード管理

レコード単位または一括の完全なCRUDと、認証を一切必要としない読み取り操作を提供します。

対応するDNSレコードタイプ：A、AAAA、CNAME、MX、TXT、NS、SOA、PTR、SRV、CAA、DS、TLSA、SSHFP、HTTPS、SVCB、NAPTR、SPF。初回の操作で特につまずきやすい書式規則が二つあります。zoneNameの末尾にはドットを付けず、CNAME、MX、NSレコードのrdata値には末尾のドットを付けます。

ドメイン単位のトグル

個別のDNSレコードとは別に、機能全体のオンとオフを切り替えます。

DNSSECは、これらのトグルには含まれません。domainSetupOptionsの一フィールドとして登録時に設定するもので、上のregisterDomainとは別に後からエージェントが呼び出す独立したエンドポイントではありません。

ドメイン設定

自動更新を有効にすると、所有者ウォレットの決済手段を使って、有効期限前にドメインが自動更新されます。ポートフォリオ全体でデフォルトのまま有効にするのではなく、ドメインごとに慎重に判断すべき継続的な承認です。

アウトバウンドリード発掘

所有するドメインを静的な資産一覧ではなく営業パイプラインに変える、最も新しい機能です。

レスポンスには、スコア、モデルの詳細、除外されたリードの状態といった内部の順位付け方式は含まれません。そのため、人間向けに結果を要約するエージェントが参照できるのは、公開された根拠、発見した連絡先、文面の有無だけです。

決済とアカウント

検索、登録、DNS、ドメイン設定、アウトバウンド、決済の範囲に含まれるすべての操作は以上です。それぞれ単一のサーバー接続を通じてMCPツールとして利用でき、MCPを使わないエージェントでは通常のHTTPS呼び出しとして利用できます。（Namefi APIは、この一覧以外にもアカウント管理やEIP-712/SIWEの補助操作をいくつか公開しています。全体の最新情報は、下の出典にリンクしたOpenAPI仕様で確認できます。）

認証モデル：三つの経路、すべての背後に一つのウォレット

上記のすべての書き込み操作は、三つの経路のいずれかで同じことを確認します。呼び出し元が、ドメインを所有している、またはこれから所有するウォレットを管理しているかどうかです。どの経路が適用されるかは、単一のアカウント設定ではなく操作によって決まります。

APIキー（x-api-key）。 最も簡単な選択肢で、この一連の記事にあるすべての実例が使う方式です。namefi.io/api-keyで生成します。キーを生成したウォレットの権限を引き継ぐため、DNS書き込み、パーキング、登録を含む上記すべての操作に利用できます。SDKは不要で、通常のHTTPヘッダーとして渡します。

EIP-712型付きデータ署名。 保存したキーを使わずにプログラムから利用する場合は、各リクエストをEthereumウォレットで署名します。x-namefi-signer、x-namefi-signature、x-namefi-eip712-typeヘッダーは、タイムスタンプと300秒後に失効する一回限りのnonceを含むエンベロープでペイロードを包みます。APIキーなしでtoggleDomainParking、createDnsRecord、registerDomainなどを実行する際に必要な方式です。Namefiのドキュメントには変更される可能性があると記載されているため、ドメインと型定義はハードコードした定数ではなく、稼働中のエンドポイント（GET /v-next/eip712/domain、/eip712/types）から取得します。スマートコントラクトウォレットは直接署名できないため、承認された外部所有アカウントがコントラクトに代わって署名し、x-namefi-erc1271-accountまたはx-namefi-eip7702-accountでリクエストを承認するコントラクトを指定します。

SIWE（Sign-In with Ethereum）。 所有ドメインや注文の一覧など、呼び出しごとに新しい署名を必要としない保護された読み取り操作で使うセッショントークン（x-namefi-siwe-token）です。nonceを取得し、署名対象のメッセージを受け取り、personal_signで署名して検証した後、トークンを再利用します。

認証が不要な操作もいくつかあります。checkAvailability、getSuggestions、getDnsRecords、isDomainParked、EIP-712メタデータのエンドポイントです。これらは読み取り専用で、ドメインの公開DNSからブラウザーですでに確認できる以上の情報を公開しません。

さらに決済の層があります。registerDomainX402はx402プロトコルを通じて購入を決済します。購入者のウォレットが、USDCのようなステーブルコインについてEIP-3009のtransferWithAuthorizationに署名し、Namefiアカウントは必要ありません。registerDomainMPPは代わりに署名付きのチャレンジ・レスポンスで同じ結果を実現します。どちらも、エージェントがアカウント作成を省略し、取引ごとに支払えるようにします。暗号資産ウォレットでドメイン料金を支払う：アカウント不要では、この経路を最初から最後まで解説します。

トークン化はカタログの外ではなく、全体に関わる

registerDomainは、ドメインをNFT、つまり多くのマーケットプレイスやウォレットがすでに読み取れる標準インターフェースであるERC-721トークンとして発行します。デフォルトではBase上で、呼び出し元のAPIキーに紐づくウォレットへ発行します。nftReceivingWalletを使うと、登録時に別のウォレットまたはチェーンを受取先として指定できます。その後のDNS書き込み、パーキング、自動更新、アウトバウンドリード発掘はすべて、別のアカウントデータベースではなく、同じオンチェーンの所有権記録を確認します。OpenSeaのようなマーケットプレイスで取引されるトークン化ドメインは、DNSの管理権とERC-721の所有権を一つのオブジェクトとして引き継ぐため、二つのシステムを手動で同期する必要がありません。

三つのエージェント、同じツールセットを使う三つの方法

開発者が一回の会話でドメインを登録し、DNSまで設定します。 checkAvailabilityで名前を登録できることを確認し、registerDomainを送信するときにdomainSetupOptionsのautoRenewとdnssecを設定します。注文がSUCCEEDEDに達すると、batchCreateDnsRecordsで、デプロイプラットフォームの検証手順が待っているCNAMEとTXTレコードを書き込みます。コーディングエージェント向けNamefi MCPクイックスタートでは、エディター内でこの手順を実行します。

ドメイントレーダーがポートフォリオを管理します。 getUserDomainsで現在の保有ドメインを取得し、checkBulkAvailabilityで新しい候補を一回の呼び出しで選別し、registerDomainで取得する価値のあるものを確保します。再販売する名前にはtoggleDomainParkingでランディングページを設置し、isDomainParkedで公開されていることを確認します。ポートフォリオ全体では、getAutoRenewとtoggleAutoRenewを使い、継続的な更新承認に値する名前と、失効させてもよいほど投機的な名前を判断します。

企業が所有済みの名前についてアウトバウンドリード発掘を実行します。 getUserDomainsで使われていないドメインを見つけ、startOutboundRunで調査を開始し、getOutboundRunでSUCCEEDEDに達するまでポーリングします。listOutboundLeadsは、プロフィールからその名前を必要としそうな企業を順位付きで返します。prepareOutboundOutreachはリードごとのメール文面を一度だけ生成し、以後の呼び出しでは同じ文面を無料で返します。

エージェントが無人で実行する前に

Namefi自身のアウトバウンドドキュメントは、registerDomain、registerWithRecords、startOutboundRun、prepareOutboundOutreachの四つを影響の大きい操作として示しています。それぞれが残高を消費するか、外部から見える行動を取るためです。checkAvailabilityのような読み取り専用ツールは、自律的に実行しても危険はありません。注文の作成、稼働中ドメインへのDNSレコードの書き込み、アプローチ文面の作成には、確認手順を設ける価値があります。エージェントネイティブなドメインレジストラとは？には、レジストラのエージェント向け機能をこの観点で評価する詳しいチェックリストがあります。

このカタログを最新に保つ

この表は固定されたロードマップではなく、上記の公開日時点におけるNamefiの稼働中OpenAPI仕様を反映しています。新しい操作は、ブログ記事の表より先にnamefi.io/llms.txtとnamefi.io/llms-full.txtへ追加されます。

よくある質問

名前が利用可能か確認するだけでもAPIキーが必要ですか？

いいえ。checkAvailability、checkBulkAvailability、getSuggestionsには認証が不要なので、資金を用意する前でも、新しく接続したエージェントから利用できます。

Namefi APIキーを一度も持たずに、エージェントがこのカタログ全体を利用できますか？

はい。registerDomainX402とregisterDomainMPPは、どちらもNamefiアカウントなしでウォレット署名により登録を決済します。残りの書き込み操作は、EIP-712署名を使ってウォレットから直接実行できます。

どの経路で登録しても、ドメインは自動的にトークン化されますか？

はい。すべての登録経路でデフォルトの動作です。nftReceivingWalletを指定しない場合、ドメインはBase上で、呼び出し元のAPIキーに紐づくウォレットへERC-721 NFTとして登録されます。

自律エージェントが実行する前に、人間が確認すべき操作はどれですか？

少なくとも、Namefiのドキュメントが影響の大きい操作として示す四つ、registerDomain、registerWithRecords、startOutboundRun、prepareOutboundOutreachに加え、実際のトラフィックを処理中のドメインに対するすべてのDNS書き込みです。

エージェントを完全なカタログへ接続する

上記すべてのツールは、https://api.namefi.io/mcpという一つの接続の先で実際に稼働しています。まだ設定していない場合は、NamefiでAIエージェントを使ってドメインを登録する方法で異なる六つのクライアント向けの正確な設定を確認し、ドメイン向けllms.txtでその基盤となるディスカバリー層を理解してください。

Namefi APIキーを生成し、エージェントをサーバーへ接続してください。上記のツールがそこで待っています。

出典と参考資料

• Namefi — namefi.io/llms.txt（MCPサーバーURL、転送方式、認証、主要操作のリファレンス — このカタログの一次資料）
• Namefi — namefi.io/llms-full.txt（Web3決済とアウトバウンドリード発掘をインライン展開した単一ファイルのリファレンス）
• Namefi — namefi.io/web3/llms.txt（x402、MPP、EIP-712、SIWEの各フローを詳しく解説）
• Namefi — namefi.io/.well-known/mcp/servers.json（MCPディスカバリーディスクリプター：サーバー名、URL、転送方式、認証タイプ）
• Namefi — api.namefi.io/v-next/openapi/doc.json（機械可読OpenAPI 3仕様 — 上の機能カタログにあるすべてのoperationIdとエンドポイントの出典）
• Namefi — docs.namefi.io：認証（APIキー、EIP-712、SIWEの認証方式、操作別の認証要件、ERC-1271/EIP-7702委任）
• Namefi — docs.namefi.io：ドメインを登録する（登録リクエストのフィールド、ポーリング手順、注文ステータスの値）
• Namefi — docs.namefi.io：残高を管理する（NFSC残高とfaucetエンドポイント）
• Model Context Protocol — Model Context Protocolとは？（プロトコルの概要）
• llmstxt.org — /llms.txtファイル（Namefiのファイルが従うディスカバリー規約の仕様と根拠）
• x402.org — x402プロトコル（registerDomainX402の基盤となるHTTP 402ベースのステーブルコイン決済標準）
• Ethereum Improvement Proposals — ERC-721：非代替性トークン標準（NamefiのドメインNFTが実装するトークン標準）