XRPL

You run an MCP server that gives AI models access to XRP Ledger data and actions. It bridges conversations with XRP Ledger capabilities like balances, trust lines, NFTs, transactions, order books, and transaction submission, so AI assistants can query and act on XRP Ledger data in a standardized way.

How to use

Connect your MCP-enabled AI agent to the XRPL MCP Server and start asking for XRP Ledger data and actions. You can request an account balance and sequence, inspect trust lines and issued currencies, view NFTs owned by an account, fetch transaction history, query DEX order books, submit signed transactions, or retrieve server information. The tools are designed to be invoked by your AI assistant through the MCP interface, abstracting away the underlying XRP Ledger details.

In typical usage scenarios you will query an account to retrieve financial details, inspect relationships between accounts via trust lines, or gather historical activity for auditing or analysis. You can also pull live order book data from the DEX to inform trading strategies, and you can submit signed transactions to the XRP Ledger when your workflow requires on-chain actions.

How to install

# Prerequisites
Python 3.8+ must be available on your system

# From source
git clone https://github.com/lgcarrier/xrpl-mcp-server.git
cd xrpl-mcp-server

# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run from source
python -m xrpl_mcp_server

Configuration

The server can be configured via environment variables. The following variable controls which XRP Ledger node you connect to and is optional if you want to use the default endpoint.

XRPL_NODE_URL — XRP Ledger node URL (defaults to https://s1.ripple.com:51234/)

Available tools

get_account_info

Retrieves information about an XRP Ledger account, including balance and sequence number.

get_account_lines

Retrieves trust lines for an XRP Ledger account with optional filtering by counterparty and limit.

get_account_nfts

Retrieves NFTs owned by an XRP Ledger account with optional limit.

get_account_transactions

Retrieves the transaction history for an XRP Ledger account with options for limit, binary format, and direction.

get_server_info

Retrieves information about the connected XRP Ledger server.

submit_transaction

Submits a signed transaction blob to the XRP Ledger and returns the submission result.

get_transaction_info

Retrieves information about a specific transaction by hash.

get_book_offers

Retrieves DEX order book offers for a currency pair.