@xrplriskscore/mcp
v1.2.1
Published
MCP server for xrplriskscore.ai — exposes XRPL wallet risk scoring as Claude tools
Downloads
1,670
Maintainers
Readme
@xrplriskscore/mcp
MCP (Model Context Protocol) server for xrplriskscore.ai. Exposes XRPL wallet risk scoring, RWA compliance checks, and escrow counterparty analysis as tools for Claude Desktop, Cline, and other MCP-compatible AI clients.
The server scores and informs — it does not approve or execute transactions. That decision stays with the agent or human.
Quick start (Claude Desktop)
Run this once:
npx -p @xrplriskscore/mcp xrplriskscore-mcp-setupThen restart Claude Desktop. The tools will be available in your next conversation.
Available tools
check_xrpl_wallet_risk— full risk assessment on an XRPL walletquick_xrpl_prescore— lightweight pre-transaction scoreexplain_xrpl_risk_score— human-readable breakdown of a verdictcheck_xrpl_rwa_compliance— RLUSD, tokenized asset, and escrow compliance checkcheck_xrpl_credential_eligibility— XRPL credential-based eligibility checkcheck_xrpl_escrow_counterparty— counterparty risk analysis for escrow transactionslist_xrpl_risk_endpoints— list all available risk scoring endpoints
Each scoring tool returns a verdict: ALLOW, CHALLENGE, or BLOCK.
Payment
The free demo tier is enabled by default — good for testing and light use.
For full paid analysis, set the XRPL_SEED environment variable and use the @xrplriskscore/client SDK. Paid requests are settled on XRPL mainnet via the x402 protocol.
Paid endpoints:
/score— full risk assessment (1 XRP)/prescore— lightweight pre-score (0.1 XRP)/rwa-check— RWA compliance check (0.5 XRP)/credential-check— Permissioned Domain credential screening (0.5 XRP)/escrow-check— XLS-85 Token Escrow counterparty screening (0.5 XRP)POST /score-batch— batch 10/25/50 wallets at 20% discount (8/20/40 XRP)
How it works
When a tool is called, the MCP server contacts the xrplriskscore.ai API. For free-tier calls, results return immediately. For paid calls, the client SDK handles the x402 payment flow: HTTP 402 → sign XRPL payment with invoice ID → retry with payment proof → receive scored result.
Links
- Website: xrplriskscore.ai
- Client SDK: @xrplriskscore/client
- Issues: github.com/kynto2001-ctrl/xrplriskscore-mcp/issues
License
MIT
