English Français العربية

XRPName

Official registry AI and agents

XRPL domains for AI agents — availability, pricing, profiles, portfolio, and register links.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http xrpname 'https://xrpdomains.xyz/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "xrpname": {
            "type": "http",
            "url": "https://xrpdomains.xyz/mcp"
        }
    }
}
NPM package @xrpname/xrpname-mcp
Claude Code 
claude mcp add xrpname -- npx -y @xrpname/xrpname-mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "xrpname": {
            "command": "npx",
            "args": [
                "-y",
                "@xrpname/xrpname-mcp@0.1.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. XRPName MCP Server
  2. Tools
  3. Install
  4. Configuration
  5. Links
  6. Development
  7. License

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

ToolKindWhat it does
check_domainsreadAvailability, price, and owner for up to 25 domains at once
recommend_domainreadAI name suggestions for a keyword, with availability + price
get_domain_profilereadFull profile for a registered domain (owner, records, history)
get_portfolioreadAll domains held by an XRPL address
resolve_addressreadReverse lookup: address → primary XRPName + all owned names
get_pending_offersreadPending buy/sell offers and mints for an address
check_tx_statusreadStatus of an XRPL transaction by hash
check_order_statusreadStatus of a registration order by domain
register_domainlinkReturns an xrpdomains.xyz link to register an available domain
set_primary_domainlinkReturns a link to set a domain as the address's primary

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.

VariableDefaultPurpose
XRPDOMAINS_API_BASEhttps://xrpdomains.xyzBackend REST API base
XRPL_WSS_URLwss://xrplcluster.comXRPL node for tx status
REDIS_URL(in-memory)Optional cache/rate-limit backend
PORT3000HTTP port (remote transport only)
LOG_LEVELinfoPino 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)

License

MIT © XRPDomains. See LICENSE.

Frequently asked questions

What is XRPName?

XRPL domains for AI agents — availability, pricing, profiles, portfolio, and register links.

How do I install XRPName?

It runs as a remote server. In Claude Code: claude mcp add --transport http xrpname 'https://xrpdomains.xyz/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does XRPName need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is XRPName open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains XRPName?

It is published by XRPDomains. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.