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 整合