# XRPL-Utilities [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/XRPL-Utilities/xrpl-utilities-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 3102  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/xrpl-utilities

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

## Tools
Capabilities this server exposes over MCP:

- **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), the XLS-40 DID and whether it carries a real verification key or is a placeholder, and whether every payTo in the served x402 catalog is one the domain itself declares. That last check is the one a swapped catalog fails, because an attacker cannot edit the toml without already owning the domain. Pass address= instead of url= to ask what an ACCOUNT's claimed identity rests on - the only way to test a brand asserted in MPT metadata, which nothing validates. Verdicts: verified / partial / unverified / unreadable / mismatch. An unfetchable document returns unreadable, never a negative finding. Verifies published identity bindings only; not an endorsement of the operator, product or solvency.
- **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 denominator for any XRPL adoption claim: counts are of ledger OBJECTS, not of distinct operators or issuers. Sampled once per UTC day, with day-over-day, 7d and 30d deltas and the full series.
- **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), negative = XRP arriving (distribution).
- **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 liquid market, i.e. exchange withdrawals or a treasury/MM pulling XRP in).
- **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 mint_context block. Corrects reading a fresh RLUSD mint as XRP sell-pressure: RLUSD routed to an exchange is institutional stablecoin provisioning. Amounts are RLUSD face value (USD-pegged ~$1).
- **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 tool calls.
- **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 the wallet's XR-Trust permissioned-domain role. Returns summary, key_numbers and sections; each section says ok, stale or unreadable. Not charged if the main scan fails.
- **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 impact for $1M, $10M and $100M (XR-Telemetry). Returns summary, key_numbers and sections; each section says ok, stale or unreadable.
- **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_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_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, because a market maker replacing its own offers as the reference price moves is one behaviour, not hundreds of events - that churn is ~94% of raw permissioned-DEX volume and is normal market making, not an anomaly. Filter with category=lifecycle to see only domain and credential changes, which are the rare institutional signal. Carries a rollup of the whole window so the churn is visible as a proportion.
- **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. Cross-issuer daily RWA flow series: mint/burn event counts per day and USD-pegged net inflow aggregate. Complements the paid per-issuer scan.
- **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 AUM reading, daily history, and on-chain exchange-flow delta.
- **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.
- **xrpl_flows_etf_flow_summary** — Paid ($0.01 USD). Daily ETF flow summary: per-ticker AUM with day-over-day delta, growth rate, and aggregate XRP supply share.
- **xrpl_ledger_statement** — Paid ($0.10 USD, RLUSD or XRP on XRPL, or USDC on Base). Account statement for 1-10 XRPL addresses rolled into one: monthly periods with XRP in/out/net, fees, activity categories, per-token net change (exact decimal strings), top counterparties and plain-English statement lines.
- **xrpl_ledger_schema** — Free. XR-Ledger response schema: request fields, every statement field and its meaning, and the payment rails the paid statement accepts.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## What XRPL-Utilities MCP server does

XRPL-Utilities exposes read endpoints from several XRPL-Utilities services as MCP tools for AI agents. The portfolio covers wallet activity analysis, normalized XRPL events, macro and DEX telemetry, permissioned assets, real-world assets, ETF relationships, account statements, and composite market briefings.

All 46 tools are read-only. XR-Sentinel classifies wallet activity and provides signals, label context, narratives, and an origin-verification check. XR-Pulse supplies recent events and market views such as whale movements, exchange flows, Ripple counterparties, escrow schedules, RLUSD distribution, token health, and RWA summaries. Other services cover settlement series, permissioned-domain operators, issuer flows, ETF correlations, address statements, and desk-level market posture.

## How it works

The package acts as a stateless passthrough proxy. It does not hold wallets, create user accounts, or fund requests. A client can start it locally with stdio or connect to the hosted MCP endpoint at `https://mcp.xrpl-utilities.io/mcp`.

Free tools can be called directly. Paid tools return an x402 `PaymentRequired` object when no valid payment is supplied. The client signs an accepted payment option and retries the same call using `_meta["x402/payment"]`; the server forwards that payload to the underlying service. Clients that cannot set MCP metadata can send a base64-encoded payment payload through the `payment_signature` argument. Successful responses include settlement information in `_meta["x402/payment-response"]`.

Payment rails include XRP or RLUSD on XRPL and USDC on Base mainnet. Deep-dive and feed calls cost $0.10 per call, while XR-Pulse data tools cost $0.01 per call.

## Setup and configuration

For Claude Desktop, install the package on demand with `npx` and select stdio transport:

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

Restart the client after adding the entry. Remote clients can use the hosted `/mcp` endpoint. For local development, install dependencies, build the package, and start HTTP transport on port 8080:

```bash
npm install
npm run build
node dist/index.js --transport http --port 8080
```

MCP Inspector can connect to `http://localhost:8080/mcp`. `MCP_BYPASS_KEY` provides an optional operator-controlled bypass for demos or trusted callers. `STRICT_VALIDATE=1` changes manifest validation failures from warnings to startup drift failures.

## Tools and capabilities

- Classify XRPL wallet activity and inspect historical signals.
- Verify that an x402 seller controls the advertised XRPL account.
- Query XRPL events, whale flows, exchange activity, escrow, RLUSD, and token health.
- Inspect XRPL macro metrics, settlement data, and DEX pair volumes.
- Explore permissioned domains, operators, issuers, jurisdictions, and activity.
- Track RWA supply and flows, ETF relationships, account statements, and desk briefings.

## Limitations and notes

The tools only read data; they do not submit XRPL transactions. Paid access requires a wallet on at least one supported payment rail and a signed payment for each paid call. XRPL payments use an XRPL Payment, while the Base option uses EIP-3009 `transferWithAuthorization`. The server forwards requests and does not custody payment funds or wallet credentials.

An operator bypass key is not part of the public tool schema and requires a client that permits the extra argument, such as a raw JSON-RPC request. The hosted endpoint limits failed bypass-key guesses separately from normal free and paid traffic.

_Full upstream README: https://allmcps.com/mcp/xrpl-utilities/readme_