There are two ways to ask the XRP Ledger a question in plain English: the chat at xrpl.to/ai, or the xrpl.to MCP server inside an AI tool you already use, such as Claude Code. Both read the same live data: token prices, holders, trades, wallets, NFTs, AMM pools and a list of known scam accounts.
The chat
Open xrpl.to/ai and type a question: "Is SOLO safe to buy?", "Who owns this wallet?", "Trending tokens today". The chat looks up the data, answers, and can also prepare a swap. You sign the swap in your own wallet in the browser, so your keys never leave your device.
You pay in one of two ways:
- Credits, bought from your wallet. A typical question costs about 3 cents with the default model.
- Your own key from Anthropic, OpenAI, Google, xAI, Mistral, DeepSeek, Groq, OpenRouter or Ollama.
The MCP server
https://api.xrpl.to/v1/mcp is a Model Context Protocol server over Streamable HTTP. It has 89 tools and 8 ready-made prompts, and it never signs a transaction for you. Listing the tools needs no key. Calling a tool needs an API key with a credit pack (from $5, you pay per call) or a paid plan, from the dashboard.
1. List the tools
Request
curl -s https://api.xrpl.to/v1/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
| jq '{count: (.result.tools | length), first: [.result.tools[0:6][].name]}'
Response
{
"count": 89,
"first": [
"search_tokens",
"get_token",
"get_trending_tokens",
"get_new_launches",
"get_trades",
"get_holders"
]
}
2. Call a tool
Request
curl -s https://api.xrpl.to/v1/mcp \
-H "X-Api-Key: $XRPLTO_KEY" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_trending_tokens","arguments":{"limit":3}}}' \
| jq '.result.content[0].text | fromjson | .tokens[] | {name, exch, pro24h, holders}'
Response
{
"name": "EVR",
"exch": 0.08149748573146023,
"pro24h": 6.078443452741267,
"holders": 2686
}
{
"name": "ARMY",
"exch": 0.004977599767587996,
"pro24h": 0.8237313086094877,
"holders": 22030
}
{
"name": "Xmen",
"exch": 0.0002960985588034727,
"pro24h": 8.100027263505938,
"holders": 1592
}
exch is the price in XRP and pro24h the change over 24 hours, in percent. Without a key, the same call answers:
xrpl.to MCP tools need an API key with a credit pack (from $5, you pay per call) or a paid plan (Developer, Business or Professional). Get one at https://xrpl.to/dashboard and send it as the X-Api-Key header or as Authorization: Bearer. Listing tools, prompts and resources needs no key.
3. Connect Claude Code
claude mcp add --transport http xrplto https://api.xrpl.to/v1/mcp --header "X-Api-Key: YOUR_KEY"
In any other MCP client, add https://api.xrpl.to/v1/mcp as an HTTP server and send the key in an X-Api-Key header, or as Authorization: Bearer.
Then ask it something:
Request
claude -p "Which XRPL tokens are trending right now? For the top three, give the price in XRP, the 24-hour change, and whether the issuer is on a scam list." \
--allowedTools "mcp__xrplto__*"
Response (shortened)
It called get_trending_tokens once and check_scam three times, then answered:
None of the three top trending XRPL tokens has an issuer on the xrpl.to scam blocklist. All three issuers were rated low risk and are over a year old.
| # | Token | Issuer | Price (XRP) | 24h change | On scam list? |
|---|---|---|---|---|---|
| 1 | EVR (GateHub) | ra9g3LAJm9xJu8Awe7oWzR6VXFB1mpFtSe |
0.08150 | +6.08% | No (first seen 2024-06-18) |
| 2 | ARMY | rGG3wQ4kUzd7Jnmk1n5NWPZjjut62kCBfC |
0.004978 | +0.82% | No (first seen 2024-11-10) |
| 3 | Xmen (Xrp Men) | rMFL2KuFPMuiujdbVGbMzNNjj5QKyd6dZf |
0.0002961 | +8.10% | No (first seen 2024-10-30) |
Not being on the blocklist only means the issuer hasn't been reported as a drainer, phishing or impersonation account. It isn't a full risk review of the token.
Prompts
The 8 prompts are ready-made investigations an MCP client can offer as commands: token-audit, investigate-wallet, trace-funds, market-brief, swap-check, new-launch-scan, whale-watch and compare-tokens.
Credit
If your app, site or bot shows this data, answers from the MCP server included, put a visible link to xrpl.to on the same screen:
<a href="https://xrpl.to" target="_blank" rel="noopener">Data by xrpl.to</a>
Next
- Every tool and prompt: xrpl.to/mcp
- The REST API under it: xrpl.to/docs
- Part 1, tokens: How to get live XRP Ledger token data with curl
- Part 2, NFTs: How to get XRP Ledger NFT data with curl
Top comments (0)