XRPL MCP Server

An MCP server that gives AI assistants structured access to XRP Ledger data and network actions.

Requirements

• Python 3.10 or newer

Features

• Get account balances and sequence numbers
• Query trust lines and issued currencies
• View NFTs owned by an account
• Retrieve account transaction history
• Fetch individual transaction details
• Inspect DEX order book offers
• Retrieve XRPL server status
• Submit signed transactions

Package Chooser

Pick the install target that matches how you plan to use the server.

Quickstart

The quickstart below is the source-checkout path for local development and MCP registration. If you only need the published package, use the PyPI install command above.

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e ".[dev]"

mcp install src/xrpl_mcp_server/server.py:mcp --with-editable .

First prompt to try:

What is the XRP balance and sequence number for account rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe?

Installation

From source

git clone https://github.com/lgcarrier/xrpl-mcp-server.git
cd xrpl-mcp-server
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e ".[dev]"

This installs the package in editable mode and includes the mcp CLI used for local development and Claude Desktop integration.

From PyPI

The published package name is different from the GitHub repository name.

python -m pip install iflow-mcp_lgcarrier-xrpl-mcp-server

Configuration

The server uses the following environment variable:

• XRPL_NODE_URL: XRP Ledger JSON-RPC endpoint. Default: https://s1.ripple.com:51234/

Safety Note

By default, the server connects to Ripple’s public mainnet endpoint. That means:

• read-only tools query live mainnet data
• submit_transaction submits a signed transaction to the live XRP Ledger network

Only use submit_transaction when you intend to broadcast a real signed transaction.

For testing, point the server to testnet before launching it:

export XRPL_NODE_URL="https://s.altnet.rippletest.net:51234/"
python -m xrpl_mcp_server

You can also install the Claude Desktop entry with the environment variable set:

mcp install src/xrpl_mcp_server/server.py:mcp --with-editable . \
  --env-var XRPL_NODE_URL=https://s.altnet.rippletest.net:51234/

Usage

Run directly from source