Skip to content

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.

Changes · 2

10 tools: 2 change things and 8 only read.

Scanned Oct 21, 2026

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/mcp

Findings

Matches of fixed checks, with the text they matched.

1 warn
  • The server marks "set_primary_domain" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true}; The name "set_primary_domain" says "set": a word for a change.

    What this check looks for

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

      Matched text

      annotations: {"readOnlyHint":true,"idempotentHint":true,"openWorldHint":true}; The name "set_primary_domain" says "set": a word for a change.

      What this check looks for
    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/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

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