{
  "markdown": "# XRPName MCP Server\n\n[![npm](https://img.shields.io/npm/v/@xrpname/xrpname-mcp?logo=npm&label=npm&color=cb3837)](https://www.npmjs.com/package/@xrpname/xrpname-mcp)\n[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-listed-6E56CF)](https://registry.modelcontextprotocol.io/v0/servers?search=xrpname)\n[![MCP Sentinel](https://img.shields.io/badge/MCP%20Sentinel-100%2F100%20SAFE-2ea043)](https://mcpsentinel.dev/servers/xrpname)\n[![M8ven Score](https://m8ven.ai/badge/mcp/xrpdomains-xrpname-mcp-server-1wexja)](https://m8ven.ai/mcp/xrpdomains-xrpname-mcp-server-1wexja)\n[![PulseMCP](https://img.shields.io/badge/PulseMCP-Official-1f6feb)](https://www.pulsemcp.com/servers/xrpname)\n[![GitHub stars](https://img.shields.io/github/stars/XRPDomains/xrpname-mcp-server?style=social)](https://github.com/XRPDomains/xrpname-mcp-server)\n[![license](https://img.shields.io/badge/license-MIT-green)](./LICENSE)\n\nXRPL domains for AI agents. XRPName exposes the [XRPDomains](https://xrpdomains.xyz)\nnaming system — `.xrp`, `.xrpl`, `.xrpfi`, `.rlusd` — over the\n[Model Context Protocol](https://modelcontextprotocol.io) so assistants like\nClaude, Cursor, and Codex can check availability, look up pricing and profiles,\nread a wallet's portfolio, and hand the user a registration link.\n\n**Read-only + web-link by design.** The server only reads public XRPL and\nregistry data; write actions (register, set primary) return an `xrpdomains.xyz`\nlink the user opens and signs in their own wallet. No API key, no private key,\nno transaction is ever built or held by this server.\n\n## Tools\n\n| Tool | Kind | What it does |\n|------|------|--------------|\n| `check_domains` | read | Availability, price, and owner for up to 25 domains at once |\n| `recommend_domain` | read | AI name suggestions for a keyword, with availability + price |\n| `get_domain_profile` | read | Full profile for a registered domain (owner, records, history) |\n| `get_portfolio` | read | All domains held by an XRPL address |\n| `resolve_address` | read | Reverse lookup: address → primary XRPName + all owned names |\n| `get_pending_offers` | read | Pending buy/sell offers and mints for an address |\n| `check_tx_status` | read | Status of an XRPL transaction by hash |\n| `check_order_status` | read | Status of a registration order by domain |\n| `register_domain` | link | Returns an `xrpdomains.xyz` link to register an available domain |\n| `set_primary_domain` | link | Returns a link to set a domain as the address's primary |\n\n## Install\n\n### Hosted (recommended — zero install)\n\nThe server runs remotely at `https://xrpdomains.xyz/mcp` (Streamable HTTP, no auth).\n\n```bash\n# Claude Code\nclaude mcp add xrpname-mcp --transport http https://xrpdomains.xyz/mcp\n```\n\nClaude Desktop / Cursor — add to the MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"xrpname-mcp\": { \"url\": \"https://xrpdomains.xyz/mcp\", \"transport\": \"http\" }\n  }\n}\n```\n\n### Local (this npm package — stdio)\n\nRuns the same tools locally, talking to the public XRPDomains API. No credentials needed.\n\n```bash\nnpx -y @xrpname/xrpname-mcp\n```\n\nWire it into any MCP client's stdio config:\n\n```json\n{\n  \"mcpServers\": {\n    \"xrpname-mcp\": { \"command\": \"npx\", \"args\": [\"-y\", \"@xrpname/xrpname-mcp\"] }\n  }\n}\n```\n\nA one-click Claude Desktop extension (`.mcpb`) is attached to each\n[GitHub Release](https://github.com/XRPDomains/xrpname-mcp-server/releases).\n\n## Configuration\n\nAll settings are optional — defaults point at the public mainnet API.\n\n| Variable | Default | Purpose |\n|----------|---------|---------|\n| `XRPDOMAINS_API_BASE` | `https://xrpdomains.xyz` | Backend REST API base |\n| `XRPL_WSS_URL` | `wss://xrplcluster.com` | XRPL node for tx status |\n| `REDIS_URL` | _(in-memory)_ | Optional cache/rate-limit backend |\n| `PORT` | `3000` | HTTP port (remote transport only) |\n| `LOG_LEVEL` | `info` | Pino log level |\n\nSee [`.env.example`](./.env.example) for the full list (rate limiting, analytics).\n\n## Links\n\n- **Setup & all tools:** https://xrpdomains.xyz/agent\n- **MCP Registry:** `io.github.XRPDomains/xrpname-mcp-server`\n- **Repository:** https://github.com/XRPDomains/xrpname-mcp-server\n- **Issues:** https://github.com/XRPDomains/xrpname-mcp-server/issues\n\n## Development\n\n```bash\nnpm ci\nnpm run build        # tsc → dist/\nnpm test             # vitest\nnpm run typecheck    # tsc --noEmit\nnpm run dev          # remote HTTP server (watch)\nnpm run dev:stdio    # local stdio server (watch)\n```\n\n## License\n\nMIT © XRPDomains. See [LICENSE](./LICENSE).\n",
  "bytes": 4488,
  "sha": "6dbc3328e76eacdd2f9e935bc4b8600d70455b18575e8d60fc5c9597ffdcbb62",
  "repo_slug": "xrpdomains/xrpname-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_xrpdomains_xrpname_mcp_server_66215346/readme"
}