XRPName MCP Server

XRPL domains for AI agents. XRPName exposes the XRPDomains naming system — .xrp, .xrpl, .xrpfi, .rlusd — over the Model Context Protocol so assistants like Claude, Cursor, and Codex can check availability, look up pricing and profiles, read a wallet's portfolio, and hand the user a registration link.

Read-only + web-link by design. The server only reads public XRPL and registry data; write actions (register, set primary) return an xrpdomains.xyz link the user opens and signs in their own wallet. No API key, no private key, no transaction is ever built or held by this server.

Tools

Install

Hosted (recommended — zero install)

The server runs remotely at https://xrpdomains.xyz/mcp (Streamable HTTP, no auth).

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

Claude Desktop / Cursor — add to the MCP config:

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

Local (this npm package — stdio)

Runs the same tools locally, talking to the public XRPDomains API. No credentials needed.

npx -y @xrpname/xrpname-mcp

Wire it into any MCP client's stdio config:

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

A one-click Claude Desktop extension (.mcpb) is attached to each GitHub Release.

Configuration

All settings are optional — defaults point at the public mainnet API.

See .env.example for the full list (rate limiting, analytics).

Links

• Setup & all tools: https://xrpdomains.xyz/agent
• MCP Registry: io.github.XRPDomains/xrpname-mcp-server
• Repository: https://github.com/XRPDomains/xrpname-mcp-server
• Issues: https://github.com/XRPDomains/xrpname-mcp-server/issues

Development

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)

License

MIT © XRPDomains. See LICENSE.