XRPName
by XRPDomains · remote · local (npm) · no sign-in to list tools · v0.1.1 · published by GitHub user XRPDomains
XRPL domains for AI agents — availability, pricing, profiles, portfolio, and register links.
10 tools: 2 change things and 8 only read.
Scanned Oct 21, 2026
- Deletes or cancels0Claude Code: deny
- Can't be undone0Claude Code: ask
- Changes things2Claude Code: ask: see these tools
- Only reads8Claude Code: allow: see these tools
1 check matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http xrpname https://xrpdomains.xyz/mcpFindings
Matches of fixed checks, with the text they matched.
The server marks "set_primary_domain" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true}; The name "set_primary_domain" says "set": a word for a change.
Tools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
10 tools
Changes things 2Claude Code: ask
check_domainsCheck 1 to 25 XRPL domains for registration status and cost.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it 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.
Annotations the server declares
- title: Check domains
- readOnlyHint: true
- openWorldHint: true
- idempotentHint: true
set_primary_domainGet the link to set a domain as your wallet's primary (the name shown by default for your address).1 finding
Why it is in this group
- The name "set_primary_domain" says "set": a word for a change.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Findings
- Warn
The server marks "set_primary_domain" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
What this check looks forMatched text
annotations: {"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true}; The name "set_primary_domain" says "set": a word for a change.
Description, as the server wrote it 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.
Annotations the server declares
- title: Set primary domain (returns a signing link)
- readOnlyHint: true
- openWorldHint: true
- idempotentHint: true
Only reads 8Claude Code: allow
check_order_statusCheck the backend order status for a domain you tried to register on xrpdomains.xyz.No findings
Why it is in this group
- The name "check_order_status" says "status": a word for reading.
Description, as the server wrote it 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).
Annotations the server declares
- title: Check order status
- readOnlyHint: true
- openWorldHint: true
- idempotentHint: true
check_tx_statusCheck the validation status of an XRPL transaction by hash.No findings
Why it is in this group
- The name "check_tx_status" says "status": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: Check transaction status
- readOnlyHint: true
- openWorldHint: true
- idempotentHint: true
get_domain_profileGet 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-ch…No findings
Why it is in this group
- The name "get_domain_profile" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: Get domain profile
- readOnlyHint: true
- openWorldHint: true
- idempotentHint: true
get_pending_offersGet 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-mint…No findings
Why it is in this group
- The name "get_pending_offers" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: Get pending offers
- readOnlyHint: true
- openWorldHint: true
- idempotentHint: true
get_portfolioList all XRPL domains owned by a wallet address.No findings
Why it is in this group
- The name "get_portfolio" says "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: Get portfolio
- readOnlyHint: true
- openWorldHint: true
- idempotentHint: true
recommend_domainGet AI-recommended domain suggestions for a keyword or theme (e.g.No findings
Why it is in this group
- The description's first verb is "get": a word for reading.
Description, as the server wrote it 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".
Annotations the server declares
- title: Recommend domains
- readOnlyHint: true
- openWorldHint: true
- idempotentHint: false
register_domainGet the link to register a .xrp / .xrpl / .xrpfi / .rlusd domain on xrpdomains.xyz.No findings
Why it is in this group
- The description's first verb is "get": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: Register domain (returns a signing link)
- readOnlyHint: true
- openWorldHint: true
- idempotentHint: true
resolve_addressReverse resolution: given an XRPL address, return its primary XRPName (if set) and the full list of names owned by the wallet.No findings
Why it is in this group
- The name "resolve_address" says "resolve": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: Resolve address
- readOnlyHint: true
- openWorldHint: true
- idempotentHint: true
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 0.1.1. Values in angle brackets are yours to fill in.
claude mcp add --transport http xrpname https://xrpdomains.xyz/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__xrpname__recommend_domain",
"mcp__xrpname__get_domain_profile",
"mcp__xrpname__check_tx_status",
"mcp__xrpname__check_order_status",
"mcp__xrpname__get_pending_offers",
"mcp__xrpname__get_portfolio",
"mcp__xrpname__resolve_address",
"mcp__xrpname__register_domain"
],
"ask": [
"mcp__xrpname__check_domains",
"mcp__xrpname__set_primary_domain"
],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as xrpname. Review it before you use it.
