XRPName

XRPName MCP Server

AI エージェント向けの XRPL ドメインです。XRPName は、XRPDomains のネーミングシステム「.xrp」「.xrpl」「.xrpfi」「.rlusd」を Model Context Protocol 経由で公開し、 Claude、Cursor、Codex などのアシスタントが空き状況や価格、プロフィールを確認したり、 ウォレットのポートフォリオを読み取ったり、ユーザーに登録リンクを提示したりできるようにします。

読み取り専用＋ウェブリンク方式を採用しています。 サーバーは公開されている XRPL と レジストリのデータのみを読み取ります。書き込み操作（登録、プライマリ設定）では、 ユーザーが自分のウォレットで開いて署名する xrpdomains.xyz のリンクを返します。 API キーも秘密鍵も不要で、このサーバーがトランザクションを作成したり保持したりすることはありません。

ツール

ツール	種類	内容
check_domains	読み取り	最大 25 件のドメインについて、空き状況、価格、所有者を一括確認します
recommend_domain	読み取り	キーワードに基づいて AI が名前を提案し、空き状況と価格も確認します
get_domain_profile	読み取り	登録済みドメインの完全なプロフィール（所有者、レコード、履歴）を取得します
get_portfolio	読み取り	XRPL アドレスが保有するすべてのドメインを取得します
resolve_address	読み取り	逆引き：アドレス → プライマリ XRPName と所有するすべての名前
get_pending_offers	読み取り	アドレスの保留中の売買オファーとミントを取得します
check_tx_status	読み取り	ハッシュを指定して XRPL トランザクションのステータスを確認します
check_order_status	読み取り	ドメインを指定して登録注文のステータスを確認します
register_domain	リンク	空いているドメインを登録するための xrpdomains.xyz リンクを返します
set_primary_domain	リンク	ドメインをアドレスのプライマリに設定するリンクを返します

インストール

ホステッド（推奨 — インストール不要）

サーバーは https://xrpdomains.xyz/mcp でリモート実行されます（Streamable HTTP、認証不要）。

# Claude Code
claude mcp add xrpname-mcp --transport http https://xrpdomains.xyz/mcp

Claude Desktop / Cursor — MCP 設定に追加します：

{
  "mcpServers": {
    "xrpname-mcp": { "url": "https://xrpdomains.xyz/mcp", "transport": "http" }
  }
}

ローカル（この npm パッケージ — stdio）

同じツールをローカルで実行し、公開 XRPDomains API と通信します。認証情報は不要です。

npx -y @xrpname/xrpname-mcp

任意の MCP クライアントの stdio 設定に組み込みます：

{
  "mcpServers": {
    "xrpname-mcp": { "command": "npx", "args": ["-y", "@xrpname/xrpname-mcp"] }
  }
}

ワンクリックでインストールできる Claude Desktop 拡張機能（.mcpb）は、 各 GitHub Release に添付されています。

設定

すべての設定は省略可能です。デフォルトでは公開メインネット API を参照します。

変数	デフォルト	用途
XRPDOMAINS_API_BASE	https://xrpdomains.xyz	バックエンド REST API のベース URL
XRPL_WSS_URL	wss://xrplcluster.com	トランザクションステータス確認用の XRPL ノード
REDIS_URL	(in-memory)	オプションのキャッシュ／レート制限用バックエンド
PORT	3000	HTTP ポート（リモートトランスポートのみ）
LOG_LEVEL	info	Pino のログレベル

全設定（レート制限、アナリティクス）については .env.example を参照してください。

リンク

• セットアップと全ツール： https://xrpdomains.xyz/agent
• MCP Registry： io.github.XRPDomains/xrpname-mcp-server
• リポジトリ： https://github.com/XRPDomains/xrpname-mcp-server
• 問題報告： https://github.com/XRPDomains/xrpname-mcp-server/issues

開発

npm ci
npm run build        # tsc → dist/
npm test             # vitest
npm run typecheck    # tsc --noEmit
npm run dev          # remote HTTP server (watch)
npm run dev:stdio    # local stdio server (watch)

ライセンス

MIT © XRPDomains。詳しくは LICENSE を参照してください。