XRPName

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.

{
  "type": "object",
  "properties": {
    "domains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "maxItems": 25,
      "description": "List of domains to check. Each may include or omit the TLD; defaults to .xrp."
    }
  },
  "required": [
    "domains"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keyword or theme to base suggestions on, e.g. \"tom\" or \"crypto\"."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25,
      "default": 8,
      "description": "How many suggestions to return."
    },
    "tlds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "TLDs to include (without dots), e.g. [\"xrp\",\"xrpfi\"]. Omit for all."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "Domain to look up, e.g. \"alice.xrp\""
    },
    "include_history": {
      "type": "boolean",
      "default": false,
      "description": "Include the on-chain ownership timeline (transfers, marketplace sales)."
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "tx_hash": {
      "type": "string",
      "pattern": "^[A-Fa-f0-9]{64}$",
      "description": "64-character hex XRPL transaction hash"
    }
  },
  "required": [
    "tx_hash"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The domain whose order to check, e.g. \"alice.xrp\"."
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "XRPL r... address of the wallet to query (e.g. \"rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe\")."
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "XRPL r... address whose domains to list."
    },
    "sort": {
      "type": "string",
      "enum": [
        "recent",
        "length-asc",
        "length-desc",
        "name-asc"
      ],
      "default": "recent",
      "description": "Sort order. \"recent\" keeps the backend order."
    },
    "filter_tld": {
      "type": "string",
      "default": "all",
      "description": "Filter by TLD, e.g. \".xrp\", \".xrpfi\", \".rlusd\", or \"all\"."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 50,
      "description": "Max domains to return."
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "XRPL classic address, e.g. \"rLhi87eXFZNueP4Kg1jUuHmm7pWZBoT3Yn\"."
    },
    "include_history": {
      "type": "boolean",
      "default": false,
      "description": "If true, include per-domain nftoken_id and mint date."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "default": 100,
      "description": "Maximum number of domains to return (cap 200)."
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The domain to register, e.g. \"coolname.xrpfi\"."
    },
    "refcode": {
      "type": "string",
      "description": "Optional referral code to embed in the registration link."
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "domain": {
      "type": "string",
      "description": "The domain to set as primary, e.g. \"alice.xrp\"."
    }
  },
  "required": [
    "domain"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}