XRPName MCP Server

Name: XRPName
Author: xrpdomains

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).

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)

XRPName