Spec Driven Development
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
作者提供的说明(英文原文)
XRPL data tools for AI agents: wallet classifier, signals, RWA tracker, ETF flows. Pay via x402.
这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。
我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。
选择你使用的 AI 应用,然后复制设置。
你需要
你用的是哪个应用?
在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。
适用于网页版、桌面版和手机版 Claude:
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/mcpclaude mcp add xrpl-utilities -- npx -y @xrpl-utilities/mcp粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json
{
"mcpServers": {
"xrpl-utilities": {
"url": "https://mcp.xrpl-utilities.io/mcp"
}
}
}粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json
{
"mcpServers": {
"xrpl-utilities": {
"command": "npx",
"args": [
"-y",
"@xrpl-utilities/mcp"
]
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"xrpl-utilities": {
"type": "http",
"url": "https://mcp.xrpl-utilities.io/mcp"
}
}
}粘贴到项目中的 .vscode/mcp.json
{
"servers": {
"xrpl-utilities": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@xrpl-utilities/mcp"
]
}
}
}浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。
ChatGPT 只能连接互联网上的服务器:
https://mcp.xrpl-utilities.io/mcp菜单名称可能因套餐和版本不同而略有差异。
你的选择通过 Cookie 保存在这台设备上,无需账户。
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
工具名称和描述与服务器在 2026年11月6日 报告的完全一致。这些内容由作者撰写,不是我们写的;我们以纯文本形式显示。
xrpl_sentinel_scanPaid ($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_historyPaid ($0.10 USD). Return up to 25 prior recorded scans for an address to read score trajectory over time.
xrpl_sentinel_verify_originFree. 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_eventsPaid ($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_addressPaid ($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_purchasePaid (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_counterpartiesPaid ($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_topologyPaid ($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_attributionPaid ($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_statsFree. XRPL network summary: funded addresses, trustline count, offer count, 24h active addresses, and snapshot freshness.
xrpl_pulse_xrpl_primitivesPaid ($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_24hPaid ($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_deltaPaid ($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_summaryPaid ($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_flowPaid ($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_calendarPaid ($0.01 USD). Forward-looking Ripple XRP escrow release calendar with monthly unlock schedule, relock history, and net release rate.
xrpl_pulse_entity_positioningPaid ($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_distributionPaid ($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_briefingPaid ($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_checkPaid ($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_briefingPaid ($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_reportPaid ($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_reportPaid ($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_reportPaid ($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_snapshotPaid ($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_healthPaid ($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_censusPaid ($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_historyPaid ($0.01 USD). Daily whale and institutional USD flow history on XRPL, one row per UTC day.
xrpl_pulse_rwa_supply_historyPaid ($0.01 USD). Daily supply change per tracked real-world-asset issuer on XRPL, in each token's own units.
xrpl_pulse_xls85_totalsPaid ($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_graphPaid ($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_choreographiesPaid ($0.01 USD). Recent coordinated institutional move patterns on XRPL: groups of linked payments that happen together.
xrpl_pulse_top_destinationsPaid ($0.01 USD). Wallets receiving XRP from several watched source wallets, ranked by how many distinct sources pay them.
xrpl_pulse_moex_xrp_indexPaid ($0.01 USD). Moscow Exchange XRP index: latest value and daily history.
xrpl_telemetry_snapshotPaid ($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_quotePaid 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_statusPaid flow step 2 (no extra charge). Poll invoice status from get_quote. Returns paid (bool), amount, ledger_index, and expiry.
xrpl_telemetry_get_resultsPaid flow step 3 (no extra charge). Fetch full Telemetry snapshot payload once invoice is paid. Same shape as xrpl_telemetry_snapshot.
xrpl_telemetry_settlement_totalsFree. XRPL settlement volume rollup: 24h/7d/30d USD volume across XRP and RLUSD, annualized run rate, and payment counts.
xrpl_telemetry_settlement_seriesPaid ($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_volumePaid ($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_liquidityPaid ($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_historyPaid ($0.01 USD). Per-exchange daily XRP flow series on XRPL: inbound, outbound and net per venue per day.
xrpl_trust_list_domainsPaid ($0.10 USD). List all XRPL PermissionedDomain (XLS-80) objects on mainnet with owner, accepted credentials, and institutional issuer counts. Paginated.
xrpl_trust_get_domainPaid ($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_issuersPaid ($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_eventsPaid ($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_indexFree. Index of all PermissionedDomain operators: address, label, jurisdiction, status, domain count, issuer count. Paginated.
xrpl_trust_operator_drilldownPaid ($0.10 USD). Deep dive on one PermissionedDomain operator: domains, credentials, jurisdiction, DID identity, institutional issuers, and lifecycle events.
xrpl_trust_operator_attributionPaid ($0.01 USD). Institutional attribution for one PermissionedDomain operator: parent funder, credential types, gated assets, plain-English summary, and confidence tier.
xrpl_trust_usage_summaryPaid ($0.01 USD). Ecosystem-wide PermissionedDomain activity aggregate: domain count, operator count, credential and market event totals over a configurable window.
xrpl_trust_jurisdictionsPaid ($0.01 USD). Jurisdiction rollup across XRPL's permissioned stack: per-country operator and issuer counts with an unattributed bucket.
xrpl_trust_permissioned_activityPaid ($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_scanPaid ($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_flowFree 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_historyPaid ($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_scanPaid ($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_correlationPaid ($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_flowPaid ($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_impactPaid ($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.
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月8日
注册名称已通过 GitHub 账户 XRPL-Utilities 验证,该账户拥有此仓库
我们还没有从 GitHub 读取这个仓库
我们还没有从 GitHub 读取这个仓库
在 979 毫秒内响应(HTTP 200)
无需登录
已读取 60 个工具描述,未发现针对 AI 的隐藏指令
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
它在 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
MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.
Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.
Talk with agent swarms: rooms, private messages and paid tasks for AI agents
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
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.
| Service | What it does | Tools |
|---|---|---|
| XR-Sentinel | XRPL wallet activity-pattern classifier: activity score, signal catalog, label context, AI narrative; a free check that an x402 seller controls the XRPL account it advertises | xrpl_sentinel_scan (paid), xrpl_sentinel_scan_history (paid), xrpl_sentinel_verify_origin (free) |
| XR-Pulse | Normalized 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_purchase | xrpl_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-Telemetry | XRPL macro snapshot (supply, liquidity, AMM, Active Float) and settlement and DEX volume series | xrpl_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-Trust | Directory and drill-down for the XRPL permissioned-asset stack (XLS-70/80/81, XLS-40 DID), operator index, jurisdictions and permissioned-domain activity | xrpl_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-Vault | Real-world asset tracker: per-issuer supply, mint and burn flow, AMM pool exposure | xrpl_vault_scan (paid), xrpl_vault_daily_flow (free, 7-day sample), xrpl_vault_daily_flow_history (paid, $0.01) |
| XR-Flows | XRP ETF AUM against XRPL exchange flow, launch impact and cross-border flow | xrpl_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-Ledger | Account statements for one XRPL address or a watchlist of up to 10: monthly XRP in/out, fees, activity categories, token net change, counterparties | xrpl_ledger_statement (paid), xrpl_ledger_schema (free) |
| XR-Desk | Composite desk briefing: market posture, positioning, RLUSD health, supply pressure, RWA market | xrpl_desk_briefing (paid, $0.01) |
| Bundles | One 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 volume | xrpl_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.
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.
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.
Point any MCP client at https://mcp.xrpl-utilities.io/mcp. Same tool list, same auth model.
To avoid 402 challenges on every call, your client needs to:
accepts entries from a prior probe. XRPL rails take an XRPL Payment; the Base rail takes an EIP-3009 transferWithAuthorization._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.
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".
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
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.
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.
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.