DEV Community

Cover image for Chat with the XRP Ledger: an AI chat and an MCP server for your agent
xrpl.to
xrpl.to

Posted on

Chat with the XRP Ledger: an AI chat and an MCP server for your agent

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]}'
Enter fullscreen mode Exit fullscreen mode

Response

{
  "count": 89,
  "first": [
    "search_tokens",
    "get_token",
    "get_trending_tokens",
    "get_new_launches",
    "get_trades",
    "get_holders"
  ]
}
Enter fullscreen mode Exit fullscreen mode

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}'
Enter fullscreen mode Exit fullscreen mode

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
}
Enter fullscreen mode Exit fullscreen mode

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"
Enter fullscreen mode Exit fullscreen mode

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__*"
Enter fullscreen mode Exit fullscreen mode

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>
Enter fullscreen mode Exit fullscreen mode

Next

Top comments (0)