XRP Names, for any AI agent

Register and manage .xrp, .xrpl, .xrpfi, .rlusd by chatting with Claude, Cursor, or any MCP‑ready client.

Explore tools Setup guide
npm version On MCP Registry MIT license
9 tools · 4 TLDs · 4 install channels · 0 private keys
The toolkit

What the agent can do

9 tools. Read-only lookups plus web-link handoffs — the MCP never builds transactions or holds keys. Every write action opens xrpdomains.xyz where your wallet signs.

Domains

5 tools
check_domains READ

Check 1–25 XRPL domains. Returns availability, pricing, owner, profile metadata if registered, and a web URL.

recommend_domain READ

AI-recommended name suggestions for a keyword or theme. Each pick is availability-checked, priced, and comes with a one-click register link.

register_domain LINK

One-click registration URL to xrpdomains.xyz. The site creates the order and your wallet signs there — the MCP builds no payment.

set_primary_domain LINK

Link to set a domain as the wallet’s primary identity. Completed in the browser with a wallet signature.

get_domain_profile READ

Full public profile: owner, NFT token ID, avatar, socials, linked addresses, and optionally the on-chain ownership history.

Portfolio

2 tools
get_portfolio READ

List all XRPL domains owned by a wallet — paginated, sorted, TLD-filterable. Includes primary flag and quick-action URLs.

get_pending_offers READ

Incoming offers, outgoing offers, and paid-but-not-minted orders — everything waiting on a wallet action.

Status

2 tools
check_tx_status READ

On-ledger validation status of any transaction by hash — pending, validated, failed, or not_found.

check_order_status READ

Backend order state for a domain you tried to register — payment landed, offer created, mint completed, or failed. Deeper than availability.

Reach

Available on every channel

One server — every way to install.

Remote HTTP

Zero install — connect over HTTP.

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

npm

Local via npx, works with any MCP client.

npx -y @xrpname/xrpname-mcp

MCP Registry

Auto-discovered by registry-aware clients.

io.github.XRPDomains/xrpname-mcp-server

Claude Desktop

One-click .mcpb extension.

Download .mcpb →
The wire

Canonical connection

One endpoint, streamable HTTP, no auth — drop this block into any MCP client.

canonical config 
{
  "name": "XRPName",
  "server_url": "https://xrpdomains.xyz/mcp",
  "transport": "streamable_http",
  "authentication": "none",
  "protocol_version": "2025-06-18",
  "registry": "io.github.XRPDomains/xrpname-mcp-server",
  "npm": "@xrpname/xrpname-mcp"
}
Transport Streamable HTTP
Protocol MCP 2025-06-18
Auth none (public)
Tools 9 (5 Domains · 2 Portfolio · 2 Status)
Expected handshake
  1. initialize → server advertises tools capability
  2. notifications/initialized
  3. tools/list → returns 9 tools
  4. tools/call → first tool invocation

Verify: curl -s -X POST https://xrpdomains.xyz/mcp -H 'Content-Type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Plug it in

One line in your AI client

Pick your client, paste the snippet, restart.

  1. 1

    Install one-liner

    terminal 
    claude mcp add xrpname-mcp --transport http https://xrpdomains.xyz/mcp
  2. 2

    Restart

    Run /quit, then relaunch claude.

Reads are public. Write actions return a xrpdomains.xyz link where your wallet signs.
Conversation

Just ask the agent

Copy a prompt, paste it into Claude or Cursor, watch the XRPL respond.

Discovery

Registration & Primary

Portfolio

Status

Common questions

What people ask first

Does the server see my private keys?
No. The MCP is read-only + web-link. For any write action (register a name, set primary), the agent returns a link to xrpdomains.xyz where you connect your wallet (Xaman, Gem, Crossmark, Bifrost, etc.) and sign there. The server never sees a seed, family seed, or private key.
Does the MCP need authentication?
No. Read tools query public XRPL data directly — no login, no token. Write actions (register, set primary) return a link to xrpdomains.xyz where you connect your wallet and sign there. The MCP server holds no keys, no sessions, no user data.
Which TLDs are supported?
.xrp, .xrpl, .xrpfi, and .rlusd. The check_domains tool normalizes inputs and returns results across all four namespaces with the same pricing tiers.
Does it work on testnet?
v1 is mainnet only. Testnet support is planned for v1.5 so developers can experiment without spending real XRP.
What does it cost?
The agent layer is free. Domain registration pricing follows xrpdomains.xyz tiers (XRP-denominated). XRPL network fees apply per-transaction (typically 12 drops, <0.01 XRP).
Is the source code open?
Server source: github.com/xrpdomains/xrpname-mcp-server. Issues and pull requests welcome. The MCP protocol itself is an open standard from Anthropic (modelcontextprotocol.io).

Wire it up.

Connect your AI client and register your first .xrp in a single sentence.

View on GitHub