Xrpl Utilities
XRPL-Utilities MCP Server
Pay-per-call XRPL data for AI agents. One MCP server, eleven tools, four backend services. Every paid call settles on XRPL mainnet via x402 v2 - no API keys, no subscriptions, no rate-limit-then-upsell.
What it covers
XR-Sentinel classifies any XRPL wallet by its on-chain activity
pattern. You get a 0-100 activity_score, an activity_level
(Low / Medium / High / Dormant / Unknown), a confidence tier, behavioral
signals from a 22-entry catalog, the top 20 counterparties with XRPScan
labels, and an AI-generated reasoning narrative. When the address has
been scanned before, the response also carries a _delta block so
agents can read trajectory without scanning N times.
XR-Pulse is a normalized signal feed. Three sources mixed into one time-ordered stream: public-source news (regulatory press, central banks, crypto media filtered for XRP / RLUSD / XRPL / Ripple), on-chain whale activity (every Payment above the storage threshold with sender + receiver + XRPScan labels), and XLS-70/80/81 permissioned-domain lifecycle events sourced from XR-Trust. News rows carry a 4-hour XRPL price-window correlation. Whale rows carry institutional watchlist labels and Sentinel cross-references.
XR-Telemetry is a macro snapshot of XRPL supply and liquidity. Total
/ circulating / escrowed / dormant XRP, AMM-locked, exchange omnibus
(with venue + address counts), DEX orderbook depth, and a derived
Active Float model that estimates the supply available for
3-second settlement. The full additive mathematical_bridge ships
with every snapshot so you can audit each component.
XR-Trust is a directory + drill-down for the XRPL permissioned-asset
stack. PermissionedDomain (XLS-80) enumeration, credential issuer
aggregation, XLS-81 permissioned-DEX trade economics, and an XLS-40
DID identity bridge that resolves .well-known/xrp-ledger.toml when
domain owners publish one.
Tools (11)
| Tool | What it does | Auth |
|---|---|---|
xrpl_sentinel_scan | Classify a wallet | inline x402 ($0.10) |
xrpl_sentinel_scan_history | Prior recorded scans for trajectory | inline x402 ($0.10) |
xrpl_pulse_recent_events | Normalized signal feed | inline x402 ($0.10) |
xrpl_telemetry_snapshot | One-shot macro snapshot | inline x402 ($0.10) |
xrpl_telemetry_get_quote | Start the async invoice flow | wrapper free; $0.10 paid via deeplink |
xrpl_telemetry_get_status | Poll an invoice | wrapper free |
xrpl_telemetry_get_results | Fetch snapshot once paid | wrapper free |
xrpl_trust_list_domains | All PermissionedDomain objects | inline x402 ($0.10) |
xrpl_trust_get_domain | Drill-down by domain_id | inline x402 ($0.10) |
xrpl_trust_credential_issuers | Issuer aggregation | inline x402 ($0.10) |
xrpl_trust_recent_events | XLS-70/80/81 lifecycle stream | inline x402 ($0.10) |
Tool names are globally namespaced (xrpl_<service>_<verb>) so they
never collide with other MCP servers a user has connected.
Install (Claude Desktop)
{
"mcpServers": {
"xrpl-utilities": {
"command": "npx",
"args": ["-y", "@xrpl-utilities/mcp", "--transport", "stdio"]
}
}
}
Add to ~/Library/Application Support/Claude/claude_desktop_config.json
(macOS) or the equivalent on your platform, then restart Claude Desktop.
The 11 tools should appear with the xrpl_ prefix.
Connect remotely (any MCP client)
URL: https://mcp.xrpl-utilities.io/mcp
Transport: streamable-http (with SSE)
Same tools, same auth model, no install needed.
How payment works
Every paid tool requires the caller to provide a payment_signature
argument: a base64-JSON-encoded x402 v2 payment header signing an
XRPL Payment that matches one of the requirements returned by an
unauthenticated probe. The MCP server forwards it as the
PAYMENT-SIGNATURE header on the underlying call. $0.10 USD lands on
the operator wallet per successful call, settled inline via the
t54 facilitator.
Both XRP (dynamic, ~71,428 drops at $1.40 spot) and RLUSD (flat 0.10) are accepted. Pick the asset that matches your wallet's holdings.
If you call a paid tool without payment_signature, the server
returns the actual 402 challenge wrapped in the MCP response so the
LLM can sign and retry on the next turn. No work runs and no money
moves until a valid signature is supplied.
The Telemetry async invoice tools (get_quote, get_status,
get_results) are an alternative payment path for clients that don't
sign x402 headers inline. The wrapper itself doesn't need a payment
header; the $0.10 settles when the caller sends an XRPL Payment to
the deeplink returned by get_quote.
The Python reference client is
x402-xrpl - useful as a
template even if you build in another language.
Stateless passthrough
The MCP server holds no wallets, takes no cut, and runs no proprietary logic. It's a thin proxy that translates MCP tool calls into HTTP requests against the four underlying services. Source is MIT-licensed and public; the published npm artifact carries sigstore provenance attestation showing it was built from this repo by GitHub Actions.
Links
- Source: https://github.com/XRPL-Utilities/xrpl-utilities-mcp
- npm: https://www.npmjs.com/package/@xrpl-utilities/mcp
- Hosted endpoint: https://mcp.xrpl-utilities.io/mcp
- Marketing site: https://xrpl-utilities.com
- License: MIT
Server Config
{
"mcpServers": {
"xrpl-utilities": {
"command": "npx",
"args": [
"-y",
"@xrpl-utilities/mcp",
"--transport",
"stdio"
]
}
}
}