XRPName

io.github.XRPDomains由 GitHub 账号 XRPDomains 发布v0.1.1更新于 Oct 24, 2026

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

发布方自己的服务:Name.ai MCP Server

已验证Streamable HTTP可网页运行网页搜索与抓取金融

概览

AI 生成的概览

只读的 XRPL 域名查询服务器:查询可用性与价格、查看域名资料和钱包持仓,并给出 .xrp 域名注册链接。

可以做什么
  • 一次查询最多 25 个 XRPL 域名的可用性、价格和持有人,并按关键词给出带可用性与价格的命名建议
  • 查看单个域名的公开资料,包括持有人、元数据、社交账号、关联地址,可选查询链上持有历史
  • 列出钱包持有的域名、将地址反查为主域名,并列出待处理的报价与待铸造订单
  • 按交易哈希查询 XRPL 交易状态,或按域名查询注册订单状态
  • 返回用于注册域名或设置主域名的 xrpdomains.xyz 链接,由用户在浏览器中完成
适用场景
适合用户询问某个 .xrp、.xrpl、.xrpfi 或 .rlusd 名称是否已被占用、价格多少、想要命名建议,或想查看某钱包的域名持仓与报价时使用。也适合只需引导用户前往注册页面、而非在对话中直接购买的情况。
运行要求
可使用托管远程端点(Streamable HTTP,无需认证),或通过 npx 运行本地 npm 包(需 Node.js)。无需 API 密钥或凭据。可选配置包括 XRPDOMAINS_API_BASE、XRPL_WSS_URL、REDIS_URL、PORT 和 LOG_LEVEL;需要能访问公开的 XRPDomains API 与 XRPL 节点。
安装前请注意
设计上为只读:注册和设置主域名不由服务器执行,只返回链接,由用户自行打开并在自己的钱包中签名。查询会发往公开的 XRPDomains API 和 XRPL 节点,因此查询内容和钱包地址会发送给这些第三方。REDIS_URL 及分析相关等可选配置可能指向外部服务。

安装

在 SourceWeft 中

  1. 打开 控制台中的 XRPName,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.XRPDomains%2Fxrpname-mcp-server/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

来源:README.md,提交 acfe598

工具

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.

输入参数domains必填

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

输入参数tldslimitquery必填

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.

输入参数domain必填include_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.

输入参数tx_hash必填

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

输入参数domain必填

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.

输入参数address必填

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.

输入参数sortlimitaddress必填filter_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.

输入参数limitaddress必填include_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.

输入参数domain必填refcode

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.

输入参数domain必填

版本历史

1
  1. v0.1.1最新Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。

其他 Name 集成