原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。评价和账户功能将在后续阶段推出。
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

XRPL-Utilities

作者:XRPL-Utilities版本 0.2.244i★ –i电脑或云端
注册名称io.github.XRPL-Utilities/mcp

安装

概览

作者提供的说明(英文原文)

XRPL data tools for AI agents: wallet classifier, signals, RWA tracker, ETF flows. Pay via x402.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

安装

选择你使用的 AI 应用,然后复制设置。

安装之前

你需要

  • 在云端运行无需安装任何东西,通过互联网连接
  • npm已安装 Node.js(用于 npx 命令)

你用的是哪个应用?

在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。

适用于网页版、桌面版和手机版 Claude:

  1. 打开 Settings → Connectors
  2. 点击 Add custom connector
  3. 粘贴下面的地址,然后点击 Add
  4. 如果要求登录,请登录作者的服务
SettingsConnectors1+ Add2https://…3
https://mcp.xrpl-utilities.io/mcp

或者在你的电脑上运行

打开 Claude Desktop → Settings → Developer → Edit Config,把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "xrpl-utilities": {
      "command": "npx",
      "args": [
        "-y",
        "@xrpl-utilities/mcp"
      ]
    }
  }
}

在终端中运行这条命令

claude mcp add --transport http xrpl-utilities https://mcp.xrpl-utilities.io/mcp

或者在你的电脑上运行

claude mcp add xrpl-utilities -- npx -y @xrpl-utilities/mcp

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "xrpl-utilities": {
      "url": "https://mcp.xrpl-utilities.io/mcp"
    }
  }
}

或者在你的电脑上运行

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "xrpl-utilities": {
      "command": "npx",
      "args": [
        "-y",
        "@xrpl-utilities/mcp"
      ]
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "xrpl-utilities": {
      "type": "http",
      "url": "https://mcp.xrpl-utilities.io/mcp"
    }
  }
}

或者在你的电脑上运行

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "xrpl-utilities": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@xrpl-utilities/mcp"
      ]
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

ChatGPT 只能连接互联网上的服务器:

  1. 打开网页版 ChatGPT → Settings → Connectors (Apps)
  2. 点击 Create 或 Add(部分套餐需要先在 Advanced 中开启 Developer mode)
  3. 粘贴下面的地址,起个名字,然后保存
  4. 如果要求登录,请登录作者的服务
SettingsConnectors1+ Create2https://…3
https://mcp.xrpl-utilities.io/mcp

菜单名称可能因套餐和版本不同而略有差异。

你的选择通过 Cookie 保存在这台设备上,无需账户。

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

它能做什么

工具名称和描述与服务器在 2026年11月6日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。

  • xrpl_sentinel_scan

    Paid ($0.10 USD). Classify an XRPL wallet by on-chain activity pattern. Returns activity_score (0-100), activity_level, confidence, behavioral signals, top counterparties, and AI reasoning.

  • xrpl_sentinel_scan_history

    Paid ($0.10 USD). Return up to 25 prior recorded scans for an address to read score trajectory over time.

  • xrpl_sentinel_verify_origin

    Free. Before paying an unfamiliar x402 seller, check whether the origin actually controls the XRPL account it advertises. Cross-checks the domain's .well-known/xrp-ledger.toml against each account's on-ledger Domain field (two-way - either half alone is one party's self-assertion

  • xrpl_pulse_recent_events

    Paid ($0.10 USD). Most-recent XRPL signal events newest-first. Mixes news, whale activity, permissioned-domain lifecycle, Sentinel signals, and RWA issuer flows. Filterable by kind, time range, and min whale USD.

  • xrpl_pulse_events_by_address

    Paid ($0.10 USD). Pulse events referencing a specific XRPL address (whale, sentinel signal, news, permissioned-domain). Complements xrpl_sentinel_scan with event history.

  • xrpl_pulse_stream_purchase

    Paid (tiered: 1h ~$0.50 / 6h ~$2.50 / 24h ~$7.50). Buy a time-boxed WebSocket subscription to live Pulse events. Returns a stream_token JWT and ws_url. Server-side filtering by source, signal, and min USD is bound into the token at purchase.

  • xrpl_pulse_ripple_counterparties

    Paid ($0.01 USD). Anonymized Ripple-counterparty auto-discovery and relay-burst detector findings. Score-tier and funding-source distributions; specific wallet addresses not exposed.

  • xrpl_pulse_ripple_topology

    Paid ($0.01 USD). Ripple ecosystem topology map: Source (treasury/issuer/escrow wallets), Pipeline (curated middle layer by role), and Exits (named CEX hot wallets).

  • xrpl_pulse_cex_attribution

    Paid ($0.01 USD). CEX attribution walker findings: backward-walked payment chains ending at named exchanges. Hop count, total USD, anchor and terminal labels; specific addresses not exposed.

  • xrpl_pulse_network_stats

    Free. XRPL network summary: funded addresses, trustline count, offer count, 24h active addresses, and snapshot freshness.

  • xrpl_pulse_xrpl_primitives

    Paid ($0.01 USD). Ledger-wide XRPL object counts: PermissionedDomain, Credential, DID, Oracle, MPTokenIssuance, AMM, Escrow, DepositPreauth, Check, PayChannel, NFTokenPage and more, plus canonical XRP supply (total, burned, escrowed, circulating) and AMM aggregates. This is the d

  • xrpl_pulse_whale_flow_24h

    Paid ($0.01 USD). Trailing 24h whale Payment aggregate: total USD, tx count, top labels, per-currency breakdown. No specific addresses returned.

  • xrpl_pulse_exchange_flow_delta

    Paid ($0.01 USD). Per-UTC-day series of net XRPL exchange flow: inbound, outbound, net, and settlement volume. Same series used in XR-Flows ETF correlation.

  • xrpl_pulse_rwa_summary

    Paid ($0.01 USD). Cross-issuer RWA rollup: obligations, net-circulating supply, trustline count, 24h mint/burn flow, and AMM pool exposure per tracked issuer.

  • xrpl_pulse_exchange_net_flow

    Paid ($0.01 USD). Per-exchange directional net flow from labeled whale events. Inflow/outflow/net per named exchange with trend and market positioning flag. Holder-centric sign: net_flow_usd = outflow minus inflow, so positive = XRP leaving the exchange (off-exchange accumulation

  • xrpl_pulse_escrow_calendar

    Paid ($0.01 USD). Forward-looking Ripple XRP escrow release calendar with monthly unlock schedule, relock history, and net release rate.

  • xrpl_pulse_entity_positioning

    Paid ($0.01 USD). Per-entity (exchange, treasury, MM) accumulation vs distribution scoring from labeled whale events with daily breakdown. net_usd is the objective balance delta (inflow minus outflow); net_direction is holder-centric and role-aware (accumulation = XRP leaving the

  • xrpl_pulse_rlusd_distribution

    Paid ($0.01 USD). RLUSD mint-to-CEX distribution: where Ripple's freshly-minted RLUSD goes. Splits outgoing RLUSD from the distribution wallet into by_exchange (named venue), to_labeled_non_exchange (transit hops, consolidators, MMs), and unattributed, with to_exchange_pct + a mi

  • xrpl_desk_briefing

    Paid ($0.01 USD). Composite desk briefing: market posture, headline narrative, positioning (top accumulator/distributor + reversals), RLUSD health (velocity + growth + peg), supply pressure (escrow + relock), RWA market, whale activity, and alerts. One call replaces 6-8 separate

  • xrpl_wallet_check

    Paid ($0.25 USD). Bundle: who an XRPL wallet is and what it has been doing, in one call and one payment. Combines the XR-Sentinel activity scan (with change since the previous scan and narrative), a domain check, XR-Pulse events for the address, a 90-day XR-Ledger statement and t

  • xrpl_xrp_market_briefing

    Paid ($0.05 USD). Bundle: what is moving the XRP market today, in one call and one payment. Market posture and headline, whale count (1M+ XRP wallets) and its change, exchange net flow, entity positioning, Ripple escrow calendar, XRP fund holdings (XR-Flows) and on-ledger sell im

  • xrpl_rwa_token_report

    Paid ($0.15 USD). Bundle: is a tokenized real-world asset on the XRP Ledger growing, and who holds it, in one call and one payment. Supply, holders (trustlines), 7 and 30-day growth and top-holder share from the XR-Pulse RWA tracker, 30 days of daily supply changes, tracked AMM p

  • xrpl_fund_flow_report

    Paid ($0.10 USD). Bundle: are XRP funds growing, and does the ledger agree, in one call and one payment. Fund assets and their change per fund, price moves included (XR-Flows), XRP held by funds, net XRP flow on and off exchanges over the same days, whether the two point the same

  • xrpl_permissioned_venue_report

    Paid ($0.10 USD). Bundle: who runs an XRPL permissioned domain (XLS-80) and is it active, in one call and one payment. XR-Trust operator profile (name, jurisdiction, domains, credentials outstanding, 24h permissioned offers, AMM events and traders), attribution and the latest dom

  • xrpl_network_snapshot

    Paid ($0.10 USD). Bundle: how big and how busy the XRP Ledger is, in one call and one payment. Funded accounts and daily active accounts and transactions with 7 and 30-day changes, ledger object counts, XRP supply (circulating, escrowed, burned), XRP and RLUSD payment volume (XR-

  • xrpl_pulse_token_health

    Paid ($0.01 USD). Per-token health scores for top 200 XRPL tokens: sovereignty, distribution, liquidity, transparency, demand pipeline. Each dimension 0-10 with green/yellow/red. Filter by issuer wallet or currency code.

  • xrpl_pulse_whale_census

    Paid ($0.01 USD). XRP whale census: every account holding 1M+ XRP, size bands, holder categories, the top 100 by balance and one history point per day. Refreshed every 6 hours; stale=true when the latest count is over a day old.

  • xrpl_pulse_whale_flow_history

    Paid ($0.01 USD). Daily whale and institutional USD flow history on XRPL, one row per UTC day.

  • xrpl_pulse_rwa_supply_history

    Paid ($0.01 USD). Daily supply change per tracked real-world-asset issuer on XRPL, in each token's own units.

  • xrpl_pulse_xls85_totals

    Paid ($0.01 USD). Token escrow (XLS-85) event counts: all time, last 7 days and last 24 hours, raw and with high-rate issuers removed, plus distinct issuers.

  • xrpl_pulse_ripple_counterparty_graph

    Paid ($0.01 USD). Two-hop graph built from the Ripple counterparty queue: nodes and edges for wallets Ripple's operational wallets pay and where that XRP goes next.

  • xrpl_pulse_recent_choreographies

    Paid ($0.01 USD). Recent coordinated institutional move patterns on XRPL: groups of linked payments that happen together.

  • xrpl_pulse_top_destinations

    Paid ($0.01 USD). Wallets receiving XRP from several watched source wallets, ranked by how many distinct sources pay them.

  • xrpl_pulse_moex_xrp_index

    Paid ($0.01 USD). Moscow Exchange XRP index: latest value and daily history.

  • xrpl_telemetry_snapshot

    Paid ($0.10 USD). One-shot XRPL macro snapshot: supply breakdown, liquidity flows, AMM state, derived Active Float model, and utility floor price. Pass sections to get only some blocks.

  • xrpl_telemetry_get_quote

    Paid flow step 1 ($0.10 USD total). Start async invoice flow: returns invoice_id, payTo address, deepLink, QR, and expiry. Pay via XRPL Payment, then poll get_status, then call get_results.

  • xrpl_telemetry_get_status

    Paid flow step 2 (no extra charge). Poll invoice status from get_quote. Returns paid (bool), amount, ledger_index, and expiry.

  • xrpl_telemetry_get_results

    Paid flow step 3 (no extra charge). Fetch full Telemetry snapshot payload once invoice is paid. Same shape as xrpl_telemetry_snapshot.

  • xrpl_telemetry_settlement_totals

    Free. XRPL settlement volume rollup: 24h/7d/30d USD volume across XRP and RLUSD, annualized run rate, and payment counts.

  • xrpl_telemetry_settlement_series

    Paid ($0.01 USD). Bucketed XRPL settlement volume time-series (daily / weekly / monthly) with USD totals, payment counts, XRP drops, and RLUSD value per bucket. Newest first, UTC-aligned. For charting or change-point detection.

  • xrpl_telemetry_dex_pair_volume

    Paid ($0.01 USD). Per-pair DEX volume on XRPL: 24h and 7d volume, fill counts, orderbook vs AMM source split, and annualized run rate.

  • xrpl_telemetry_liquidity

    Paid ($0.01 USD). XRP supply and liquidity headline: circulating, escrowed, AMM-locked and exchange-held XRP, on-ledger liquidity, modeled exchange depth, Active Float, measured free float and execution slippage per pair.

  • xrpl_telemetry_exchange_flow_history

    Paid ($0.01 USD). Per-exchange daily XRP flow series on XRPL: inbound, outbound and net per venue per day.

  • xrpl_trust_list_domains

    Paid ($0.10 USD). List all XRPL PermissionedDomain (XLS-80) objects on mainnet with owner, accepted credentials, and institutional issuer counts. Paginated.

  • xrpl_trust_get_domain

    Paid ($0.10 USD). Deep dive on one PermissionedDomain by 64-hex ID: lifecycle history, permissioned market activity (XLS-81), and DID/TOML identity.

  • xrpl_trust_credential_issuers

    Paid ($0.10 USD). All credential issuers across PermissionedDomains: address, label, referencing domain count, and credential types issued. Use limit and offset to page; omit limit for every issuer.

  • xrpl_trust_recent_events

    Paid ($0.01 USD). XLS-70/80/81 lifecycle event stream: domain creates/deletes, credential activity, permissioned offers and AMM events. Cursor-paginated.

  • xrpl_trust_list_operators_index

    Free. Index of all PermissionedDomain operators: address, label, jurisdiction, status, domain count, issuer count. Paginated.

  • xrpl_trust_operator_drilldown

    Paid ($0.10 USD). Deep dive on one PermissionedDomain operator: domains, credentials, jurisdiction, DID identity, institutional issuers, and lifecycle events.

  • xrpl_trust_operator_attribution

    Paid ($0.01 USD). Institutional attribution for one PermissionedDomain operator: parent funder, credential types, gated assets, plain-English summary, and confidence tier.

  • xrpl_trust_usage_summary

    Paid ($0.01 USD). Ecosystem-wide PermissionedDomain activity aggregate: domain count, operator count, credential and market event totals over a configurable window.

  • xrpl_trust_jurisdictions

    Paid ($0.01 USD). Jurisdiction rollup across XRPL's permissioned stack: per-country operator and issuer counts with an unattributed bucket.

  • xrpl_trust_permissioned_activity

    Paid ($0.01 USD). Newest-first feed of permissioned-domain ledger activity: XLS-70/80 domain and credential lifecycle, XLS-81 permissioned-DEX offers and AMM ops, and Payments made inside a domain. Consecutive same-account quote runs are collapsed into one row with a count, becau

  • xrpl_vault_scan

    Paid ($0.10 USD). Per-issuer RWA deep dive: supply, mint/burn flow, AMM exposure, and daily history. Accepts wallet address, issuer label, or currency code.

  • xrpl_vault_daily_flow

    Free sample. Cross-issuer daily RWA flow for the last 7 days at most: mint/burn event counts per day and the dollar-pegged net inflow. For up to 90 days with issuer wallets and candidates use xrpl_vault_daily_flow_history.

  • xrpl_vault_daily_flow_history

    Paid ($0.01 USD). Cross-issuer daily RWA flow for up to 90 days: mint/burn event counts per day, dollar-pegged net inflow, per-issuer series in native units, each tracked issuer's wallets and the auto-discovered issuer candidates.

  • xrpl_flows_scan

    Paid ($0.10 USD). Per-ETF deep dive for any tracked XRP-exposure ETF across three tiers: US spot (XRP/XRPC/XRPZ/GXRP/TOXR/XRPR), US indirect-basket (BITW/GDLC/EZPZ/NCIQ/TTOP/TXBC, XRP-attributable slice only), and European spot (AXRP.SW/WXRP.DE/GXRP.DE). Returns metadata, latest

  • xrpl_flows_correlation

    Paid ($0.01 USD). Daily ETF AUM vs XRPL exchange-flow delta across the tracked XRP-exposure funds (US spot, US indirect-basket, and European spot tiers) with 7-day rolling Pearson correlation. Correlation only, not causation.

  • xrpl_flows_cross_border_flow

    Paid ($0.01 USD). XRPL cross-border settlement flow: country-pair aggregates (inbound/outbound/net USD), top corridors, and coverage block. Institutional/exchange wallets only.

  • xrpl_flows_launch_impact

    Paid ($0.01 USD). Per-ETF launch-window analysis: [L-30, L+30] exchange-flow delta and DEX volume around each tracked XRP-exposure ETF launch date.

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月8日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 XRPL-Utilities 验证,该账户拥有此仓库

  • … 尚未检查

    仍在维护

    我们还没有从 GitHub 读取这个仓库

  • … 尚未检查

    有许可证

    我们还没有从 GitHub 读取这个仓库

  • ✓ 通过

    端点有响应

    在 979 毫秒内响应(HTTP 200)

  • – 不适用

    使用 OAuth 登录

    无需登录

  • ✓ 通过

    工具描述中没有隐藏指令

    已读取 60 个工具描述,未发现针对 AI 的隐藏指令

与“其他”中的其他服务器比较i

  • 星标数多于此分类中其他 18474 个服务器的 0%
  • 发布到注册中心的时间比此分类中其他 18474 个服务器的 94% 更新
  • 基础检查结果等于或优于此分类中其他 18474 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

XRPL-Utilities 安全吗?

它在 3 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端?

两种方式都可以:安装在你的电脑上,或者连接云端版本。

它还在维护吗?

GitHub 仓库最后更新于–,最新版本(0.2.244)于前天进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接,所以接受远程 MCP 服务器的应用也可以使用,例如开启开发者模式的 ChatGPT。

有什么可以替代它?

同一分类中有:Spec Driven Development, Remote Desktop Commander, SwarmMemo

替代选择

同一分类中其他作者的服务器,按星标数排序。

如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Spec Driven Development

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

作者:formulahendry起步阶段↓ 66/周★ 44014个月前更新

在你的电脑上运行

Remote Desktop Commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

作者:desktop-commander正在增长★ 2113天前更新

在云端运行✓ desktopcommander.app

SwarmMemo

Talk with agent swarms: rooms, private messages and paid tasks for AI agents

作者:Hugo0非常新今天更新

在云端运行✓ swarmmemo.com

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

@xrpl-utilities/mcp

Model Context Protocol server for the XRPL-Utilities™ portfolio. Exposes the read endpoints of every service as MCP tools so AI agents can discover and use them, either locally via stdio (Claude Desktop, MCP Inspector, etc.) or remotely via the hosted endpoint at mcp.xrpl-utilities.io.

Services covered

ServiceWhat it doesTools
XR-SentinelXRPL wallet activity-pattern classifier: activity score, signal catalog, label context, AI narrative; a free check that an x402 seller controls the XRPL account it advertisesxrpl_sentinel_scan (paid), xrpl_sentinel_scan_history (paid), xrpl_sentinel_verify_origin (free)
XR-PulseNormalized XRPL event feed (news, whale moves, RWA mints and burns, Sentinel signals) plus market views at $0.01 per call: Ripple counterparties, exchange flows, escrow calendar, RLUSD distribution, RWA summary, token health. Live WebSocket streams are sold through xrpl_pulse_stream_purchasexrpl_pulse_recent_events (paid), xrpl_pulse_events_by_address (paid), xrpl_pulse_stream_purchase (paid), xrpl_pulse_ripple_counterparties (paid, $0.01), xrpl_pulse_ripple_topology (paid, $0.01), xrpl_pulse_cex_attribution (paid, $0.01), xrpl_pulse_network_stats (free), xrpl_pulse_xrpl_primitives (paid, $0.01), xrpl_pulse_whale_flow_24h (paid, $0.01), xrpl_pulse_exchange_flow_delta (paid, $0.01), xrpl_pulse_rwa_summary (paid, $0.01), xrpl_pulse_exchange_net_flow (paid, $0.01), xrpl_pulse_escrow_calendar (paid, $0.01), xrpl_pulse_entity_positioning (paid, $0.01), xrpl_pulse_rlusd_distribution (paid, $0.01), xrpl_pulse_token_health (paid, $0.01), xrpl_pulse_whale_census (paid, $0.01), xrpl_pulse_whale_flow_history (paid, $0.01), xrpl_pulse_rwa_supply_history (paid, $0.01), xrpl_pulse_xls85_totals (paid, $0.01), xrpl_pulse_ripple_counterparty_graph (paid, $0.01), xrpl_pulse_recent_choreographies (paid, $0.01), xrpl_pulse_top_destinations (paid, $0.01), xrpl_pulse_moex_xrp_index (paid, $0.01)
XR-TelemetryXRPL macro snapshot (supply, liquidity, AMM, Active Float) and settlement and DEX volume seriesxrpl_telemetry_snapshot (paid), xrpl_telemetry_get_quote (paid, invoice), xrpl_telemetry_get_status (free, completes the invoice), xrpl_telemetry_get_results (free, completes the invoice), xrpl_telemetry_settlement_totals (free), xrpl_telemetry_settlement_series (paid, $0.01), xrpl_telemetry_dex_pair_volume (paid, $0.01), xrpl_telemetry_liquidity (paid, $0.01), xrpl_telemetry_exchange_flow_history (paid, $0.01)
XR-TrustDirectory and drill-down for the XRPL permissioned-asset stack (XLS-70/80/81, XLS-40 DID), operator index, jurisdictions and permissioned-domain activityxrpl_trust_list_domains (paid), xrpl_trust_get_domain (paid), xrpl_trust_credential_issuers (paid), xrpl_trust_recent_events (paid, $0.01), xrpl_trust_list_operators_index (free), xrpl_trust_operator_drilldown (paid), xrpl_trust_operator_attribution (paid, $0.01), xrpl_trust_usage_summary (paid, $0.01), xrpl_trust_jurisdictions (paid, $0.01), xrpl_trust_permissioned_activity (paid, $0.01)
XR-VaultReal-world asset tracker: per-issuer supply, mint and burn flow, AMM pool exposurexrpl_vault_scan (paid), xrpl_vault_daily_flow (free, 7-day sample), xrpl_vault_daily_flow_history (paid, $0.01)
XR-FlowsXRP ETF AUM against XRPL exchange flow, launch impact and cross-border flowxrpl_flows_scan (paid), xrpl_flows_correlation (paid, $0.01), xrpl_flows_cross_border_flow (paid, $0.01), xrpl_flows_launch_impact (paid, $0.01), xrpl_flows_etf_flow_summary (paid, $0.01), xrpl_flows_etf_candidates (paid, $0.01)
XR-LedgerAccount statements for one XRPL address or a watchlist of up to 10: monthly XRP in/out, fees, activity categories, token net change, counterpartiesxrpl_ledger_statement (paid), xrpl_ledger_schema (free)
XR-DeskComposite desk briefing: market posture, positioning, RLUSD health, supply pressure, RWA marketxrpl_desk_briefing (paid, $0.01)
BundlesOne call and one payment that answer a whole question from several services. Wallet check: who an XRPL wallet is and what it has been doing (Sentinel scan, domain check, Pulse events, 90-day XR-Ledger statement, XR-Trust role). XRP market briefing: posture, whale count, exchange net flow, positioning, escrow calendar, fund holdings, on-ledger sell impact. RWA token report: supply, holders, growth, AMM pools and the issuer wallet. Fund flow report: fund flows against net exchange flow on the ledger. Permissioned venue report: who runs a permissioned domain and how active it is. Network snapshot: accounts, activity, ledger objects, supply and payment volumexrpl_wallet_check (paid, $0.25), xrpl_xrp_market_briefing (paid, $0.05), xrpl_rwa_token_report (paid, $0.15), xrpl_fund_flow_report (paid, $0.10), xrpl_permissioned_venue_report (paid, $0.10), xrpl_network_snapshot (paid, $0.10)

64 tools total: 56 paid, 8 free, all read-only. Paid calls settle over x402 v2 in XRP or RLUSD on XRPL, or USDC on Base.

Auth model

The MCP server is a stateless passthrough proxy. It does not hold wallets, manage user accounts, or subsidize calls.

Paid tools speak standard x402 over MCP. Data tools (every tool marked $0.01 above) cost $0.01 USD per call. Deep dives, event queries and the Ledger statement cost $0.10. Bundles cost $0.05 (XRP market briefing), $0.10 (fund flow report, permissioned venue report, network snapshot), $0.15 (RWA token report) and $0.25 (wallet check).

Every successful paid answer carries a provenance block: the service, its schema_version, served_at, and the newest validated XRP Ledger it had read (index, hash, close_time). Each evening a fingerprint of the day's published figures is written to the XRP Ledger; anyone can check a day at xrpl-utilities.com/verify. Call a paid tool without payment and you get a tool result with isError: true and the x402 PaymentRequired object in structuredContent. It lists three payment options: XRP and RLUSD on XRPL via the t54 facilitator, or USDC on Base mainnet via the Coinbase x402 facilitator. Sign one and retry the same call with the payment payload object in _meta["x402/payment"]. A settled call returns the settlement in _meta["x402/payment-response"]. Any x402 MCP client library handles this loop for you.

Clients that can't set _meta can still pass the payload as a payment_signature argument, base64-JSON-encoded. Either way the server forwards it as the PAYMENT-SIGNATURE header on the underlying call, and the backend verifies and settles it.

Operators can set MCP_BYPASS_KEY on the server to enable an opt-in bypass for friendlies / demos. The caller passes the matching key as _bypass_key in the tool args. It is not listed in the public tool schemas, so send it from a client that does not validate arguments against tools/list (a raw JSON-RPC call works).

The hosted endpoint budgets failed _bypass_key attempts per caller separately from, and far more tightly than, ordinary requests: a 60 requests-per-minute cap is a fair-use limit, not an access control on a secret. The budget is spent per guess, not per HTTP request, so a batched JSON-RPC body cannot outrun it, and only requests that actually carry a _bypass_key are held off once it is exhausted - tools/list, free tools and paid x402 calls keep working. Batches are capped at 20 messages. Use a key of at least 32 random bytes, and scope or rotate it per service rather than sharing one portfolio-wide key. Bucket keying depends on TRUST_PROXY_HOPS matching the real number of proxies in front of the container - see .env.example.

Use it

Locally via Claude Desktop (stdio)

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{

"mcpServers": { "xrpl-utilities": { "command": "npx", "args": ["-y", "@xrpl-utilities/mcp", "--transport", "stdio"] } } }

Restart Claude Desktop. The 64 tools should appear with the prefix xrpl_. Ask Claude to "scan the wallet rXXX with XR-Sentinel" or "list permissioned domains on XRPL" and the tool calls flow through.

Remotely (HTTP/SSE)

Point any MCP client at https://mcp.xrpl-utilities.io/mcp. Same tool list, same auth model.

What you need to actually pay

To avoid 402 challenges on every call, your client needs to:

  1. Hold a wallet on at least one of the supported rails: an XRPL wallet with XRP (and optional RLUSD trustline) OR an EVM wallet with USDC on Base mainnet.
  2. On each paid tool call, sign a payment matching one of the accepts entries from a prior probe. XRPL rails take an XRPL Payment; the Base rail takes an EIP-3009 transferWithAuthorization.
  3. Send the payload in _meta["x402/payment"], or base64-JSON-encode it and pass it as payment_signature.

Reference implementations: x402-xrpl covers the XRPL rails. The official x402 package (with [evm] extras) covers the Base USDC rail. Both are useful as templates in any language.

Local dev

npm install

npm run build node dist/index.js --transport http --port 8080 npm test # builds, then runs the node:test suite in tests/

Point MCP Inspector at http://localhost:8080/mcp to walk through tool definitions interactively.

Set STRICT_VALIDATE=1 to treat a manifest that could not be read as drift instead of a warning. It is off by default because Railway restarts ON_FAILURE: failing closed on boot would crash-loop the endpoint, and take the other healthy services' tools down with it, whenever one backend is cold. Either way, a service whose manifest was not read logs NOT CHECKED - "could not check" is never reported as "all clear".

Releases

Bump the version and merge it to main. The Release workflow sees a version npm doesn't have yet, builds and tests, publishes to npm with sigstore provenance, creates the v tag, then mirrors the same version to the official MCP Registry via GitHub OIDC (no extra secrets needed).

npm version patch --no-git-tag-version   # or minor / major

commit, open a PR, merge to main; CI does the rest

Pushing a v* tag still works too (npm version patch && git push --follow-tags).

The published artifact appears at npmjs.com/package/@xrpl-utilities/mcp within ~90 seconds. Provenance attestation is visible on the package page as a green check. The MCP Registry entry lives at registry.modelcontextprotocol.io under the reverse-DNS name io.github.XRPL-Utilities/mcp.

Terms and data use

The data these tools return is on-chain data and heuristic analysis for information and research. It is not investment, legal, tax or compliance advice, and it comes with no accuracy guarantee. You are responsible for anything your agent does with it. Paid calls are covered by the Terms of Service.

License

The code in this repository is MIT licensed; see LICENSE. The XR-* names are trademarks of XRPL-Utilities LLC. Full portfolio at xrpl-utilities.com.

问 PopNx