XRPL MCP Server

A Model Context Protocol (MCP) server that provides AI models with access to XRP Ledger data and functionality.

Overview

XRPL MCP Server acts as a bridge between large language models (LLMs) like Claude and GPT and the XRP Ledger. It enables AI models to retrieve account information from the XRP Ledger through a standardized API interface.

Features

• Get account information (balance, sequence number)
• Query trust lines and issued currencies
• View NFTs owned by accounts
• Retrieve transaction history
• Access order book data from the DEX
• Submit signed transactions to the network
• Get server status information
• Reliable XRP Ledger data access through MCP
• Easy integration with MCP-compatible AI applications

Installation

From Source

1. Clone this repository:
   git clone https://github.com/lgcarrier/xrpl-mcp-server.git cd xrpl-mcp-server
2. Create and activate a virtual environment:
   python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
3. Install dependencies:
   pip install -r requirements.txt

Using pip

Configuration

The server uses the following environment variables:

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

Usage

Run from Source

Launch the server:

Run as Installed Package

Using with Claude or Other MCP-Compatible AI Assistants

1. Install the MCP:
   mcp install xrpl-mcp-server
2. The XRPL tools will be available to Claude, allowing you to ask for XRP Ledger account information.

Available Tools

get_account_info

Retrieves information about an XRP Ledger account.

Parameters:

• address (string): The XRP Ledger account address (starts with "r")

Returns:

• Account balance in XRP
• Account sequence number

get_account_lines

Retrieves trust lines for an XRP Ledger account.

Parameters:

• address (string): The XRP Ledger account address (starts with "r")
• peer (string, optional): Address of a counterparty account to filter results
• limit (integer, optional): Limit for the number of trust lines returned

Returns:

• JSON-formatted information about the account's trust lines

get_account_nfts

Retrieves NFTs owned by an XRP Ledger account.

Parameters:

• address (string): The XRP Ledger account address (starts with "r")
• limit (integer, optional): Limit for the number of NFTs returned

Returns:

• JSON-formatted information about the account's NFTs

get_account_transactions

Retrieves transaction history for an XRP Ledger account.

Parameters:

• address (string): The XRP Ledger account address (starts with "r")
• limit (integer, optional): Limit for the number of transactions returned
• binary (boolean, optional): Flag to return transactions in binary format (default False)
• forward (boolean, optional): Flag to search forward in ledger history (default False)

Returns:

• JSON-formatted information about the account's transaction history

get_server_info

Retrieves information about the connected XRP Ledger server.

Parameters:

• None

Returns:

• JSON-formatted information about the XRP Ledger server

submit_transaction

Submits a signed transaction blob to the XRP Ledger.

Parameters:

• tx_blob (string): The signed transaction blob in hexadecimal format

Returns:

• JSON-formatted submission result

get_transaction_info

Retrieves information about a specific transaction.

Parameters:

• transaction_hash (string): The hash of the transaction

Returns:

• JSON-formatted transaction details

get_book_offers

Retrieves order book offers for a currency pair on the DEX.

Parameters:

• taker_gets (object): Currency the taker wants to receive, e.g., {"currency": "XRP"} or {"currency": "USD", "issuer": "r..."}
• taker_pays (object): Currency the taker wants to pay, e.g., {"currency": "EUR", "issuer": "r..."} or {"currency": "XRP"}
• limit (integer, optional): Limit for the number of offers returned

Returns:

• JSON-formatted order book offers

Examples

Ask Claude:

What is the balance of the XRP account rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe?

Claude can then use the get_account_info tool to fetch this information directly from the XRP Ledger.

Example response:

Here's another example:

What NFTs does account rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe own?

Claude can use the get_account_nfts tool to retrieve this information.

Development

See the memory-bank directory for detailed documentation about architecture, coding rules, and implementation plans.

To set up the development environment:

License

MIT License