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
| Tool | Kind | What it does |
|---|---|---|
check_domains | read | Availability, price, and owner for up to 25 domains at once |
recommend_domain | read | AI name suggestions for a keyword, with availability + price |
get_domain_profile | read | Full profile for a registered domain (owner, records, history) |
get_portfolio | read | All domains held by an XRPL address |
resolve_address | read | Reverse lookup: address → primary XRPName + all owned names |
get_pending_offers | read | Pending buy/sell offers and mints for an address |
check_tx_status | read | Status of an XRPL transaction by hash |
check_order_status | read | Status of a registration order by domain |
register_domain | link | Returns an xrpdomains.xyz link to register an available domain |
set_primary_domain | link | Returns a link to set a domain as the address's primary |
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.
| Variable | Default | Purpose |
|---|---|---|
XRPDOMAINS_API_BASE | https://xrpdomains.xyz | Backend REST API base |
XRPL_WSS_URL | wss://xrplcluster.com | XRPL node for tx status |
REDIS_URL | (in-memory) | Optional cache/rate-limit backend |
PORT | 3000 | HTTP port (remote transport only) |
LOG_LEVEL | info | Pino log level |
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.