XRPName

io.github.XRPDomainsPublished by GitHub account XRPDomainsv0.1.1Updated Oct 24, 2026

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

The publisher's own server: Name.ai MCP Server

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingFinance

Overview

AI-generated overview

Read-only XRPL domain lookup server: check availability and prices, view profiles and portfolios, and get registration links for .xrp names.

What you can do
  • Check availability, price and owner for up to 25 XRPL domains at once, and get name suggestions for a keyword with availability and pricing
  • Look up a single domain's public profile (owner, metadata, social handles, linked addresses, optional ownership history)
  • List the domains a wallet owns, reverse-resolve an address to its primary name, and list pending offers and mints
  • Check the status of an XRPL transaction by hash or of a registration order by domain
  • Return xrpdomains.xyz links for registering a domain or setting a primary name, which the user completes in the browser
When to use it
Useful when a user asks whether a .xrp, .xrpl, .xrpfi or .rlusd name is taken or how much it costs, wants name ideas, or wants to inspect a wallet's domain holdings and offers. It also helps when someone needs a pointer to the registration page rather than an in-chat purchase.
Requirements
Either the hosted remote endpoint (Streamable HTTP, no auth) or the local npm package run via npx with Node.js. No API key or credentials. Optional settings include XRPDOMAINS_API_BASE, XRPL_WSS_URL, REDIS_URL, PORT and LOG_LEVEL; network access to the public XRPDomains API and an XRPL node is needed.
Before you install
Read-only by design: registration and setting a primary name are not performed by the server, it only returns links the user opens and signs in their own wallet. Queries go to the public XRPDomains API and an XRPL node, so lookups and wallet addresses are sent to those third parties. Optional settings such as REDIS_URL and analytics-related variables may point at external services.

Installation

In SourceWeft

  1. Open XRPName in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.XRPDomains%2Fxrpname-mcp-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

XRPName MCP Server

[npm] [MCP Registry] [MCP Sentinel] [M8ven Score] [PulseMCP] [GitHub stars] [license]

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

Hosted (recommended — zero install)

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

bash
# Claude Codeclaude mcp add xrpname-mcp --transport http https://xrpdomains.xyz/mcp

Claude Desktop / Cursor — add to the MCP config:

json
{  "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.

bash
npx -y @xrpname/xrpname-mcp

Wire it into any MCP client's stdio config:

json
{  "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).

Links

Development

bash
npm cinpm run build        # tsc → dist/npm test             # vitestnpm run typecheck    # tsc --noEmitnpm run dev          # remote HTTP server (watch)npm run dev:stdio    # local stdio server (watch)

License

MIT © XRPDomains. See LICENSE.

Source: README.md at commit acfe598

Tools

10

check_domains

Check domains

Check 1 to 25 XRPL domains for registration status and cost. Use for questions like "is <name>.xrp taken?", "how much does <name>.xrp cost?", "who owns <name>.xrp?", or to verify availability before registering. Accepts .xrp, .xrpl, .xrpfi, .rlusd TLDs (defaults to .xrp when omitted). Returns availability, price in XRP and RLUSD, owner address, profile metadata if registered, and a web URL for the user to register if available. Also returns invalid_domains for inputs that fail validation.

Parametersdomainsrequired

recommend_domain

Recommend domains

Get AI-recommended domain suggestions for a keyword or theme (e.g. "tom", "crypto", "defi"). Returns creative name + TLD combos with a category, each cross-checked for availability, priced, and given a register link. Use when a user asks "suggest names", "find me a domain about X", or "give me some .xrp ideas".

Parameterstldslimitqueryrequired

get_domain_profile

Get domain profile

Get the full public profile of a single XRPL domain — owner, NFT token ID, metadata, avatar, fullname, description, social handles, linked chain addresses, and optionally the on-chain ownership history (pass include_history=true). Use when the user asks "show me X.xrp", "what does X.xrp link to?", "who owns X.xrp?", or "show me the history of X.xrp". Returns null fields gracefully if no profile is set.

Parametersdomainrequiredinclude_history

check_tx_status

Check transaction status

Check the validation status of an XRPL transaction by hash. Use after send_signed_tx to confirm whether the transaction was validated on-ledger. Returns status (pending, validated, failed, not_found) and engine result code.

Parameterstx_hashrequired

check_order_status

Check order status

Check the backend order status for a domain you tried to register on xrpdomains.xyz. Returns whether payment landed, the offer was created, the mint completed, or it failed at a step. Use when a user asks "did my X.xrp registration go through?" or "what's the status of my order?". This is deeper than check_domains (which only shows availability).

Parametersdomainrequired

get_pending_offers

Get pending offers

Get all pending XRPL domain operations for a wallet — incoming offers (someone offered the wallet a domain), outgoing offers (the wallet listed a domain), and paid-but-not-yet-minted orders the user can still complete. Use when the user asks "do I have any pending transfers?", "what offers are waiting on me?", or before suggesting an accept/cancel/continue-mint action. Requires an XRPL r... address.

Parametersaddressrequired

get_portfolio

Get portfolio

List all XRPL domains owned by a wallet address. Use when the user asks "what domains do I own?", "show me my domains", or wants to see another wallet's holdings. Returns each domain with its TLD, length, primary flag, subname flag, and quick-action URLs. (nftoken_id, image, and mint time are not included here — use get_domain_profile for one domain.) Requires an XRPL r... address.

Parameterssortlimitaddressrequiredfilter_tld

resolve_address

Resolve address

Reverse resolution: given an XRPL address, return its primary XRPName (if set) and the full list of names owned by the wallet. Use when the user says "who owns [address]?", "look up this wallet", or "what names does [address] have?", or when chained with get_domain_profile to explore a wallet. Returns found:false if the address owns no XRPName.

Parameterslimitaddressrequiredinclude_history

register_domain

Register domain (returns a signing link)

Get the link to register a .xrp / .xrpl / .xrpfi / .rlusd domain on xrpdomains.xyz. Registration is completed in the browser — the website handles the order and the user signs in their wallet there (the MCP does NOT build or broadcast the payment). Use when the user says "register X.xrpfi" or "buy X.xrp". Pass refcode if a referral applies.

Parametersdomainrequiredrefcode

set_primary_domain

Set primary domain (returns a signing link)

Get the link to set a domain as your wallet's primary (the name shown by default for your address). Setting primary is completed in the browser — the website handles it and your wallet signs there (the MCP does NOT build or broadcast the transaction). Use when the user says "make X.xrp my primary" or "set X.xrpfi as my main domain". The wallet must already own the domain.

Parametersdomainrequired

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Name integrations