XRPL MCP Server

Name: XRPL MCP Server
Author: lgcarrier

@lgcarrier

Repository

About XRPL MCP Server

XRP Ledger MCP Server

#xrpl #mcp #server #xrp-ledger #ai-integration

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "xrpl-mcp-server": {
      "command": "python3",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is XRPL MCP Server?

An MCP server that gives AI assistants structured access to XRP Ledger data and network actions. It connects to an XRPL JSON‑RPC endpoint and provides read-only queries plus signed transaction submission. Designed for Python 3.10+ environments and integrates with MCP‑compatible hosts such as Claude Desktop.

How to use XRPL MCP Server?

Install the published package via pip install iflow-mcp_lgcarrier-xrpl-mcp-server or clone from source and pip install -e ".[dev]". Optionally set the XRPL_NODE_URL environment variable to point to mainnet (default) or testnet. Run directly with python -m xrpl_mcp_server or the installed CLI xrpl-mcp-server. To register with Claude Desktop, use mcp install src/xrpl_mcp_server/server.py:mcp --with-editable ..

Key features of XRPL MCP Server

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

Use cases of XRPL MCP Server

An AI assistant answers a user’s XRP balance and account sequence
A chatbot shows the last N transactions for a given XRPL address
An analyst inspects DEX order book offers for a currency pair
A developer verifies an NFT collection by querying account NFTs
A trading bot submits a signed payment or trust‑set transaction

FAQ from XRPL MCP Server

What Python version does XRPL MCP Server require?

Python 3.10 or newer.

How do I configure which XRPL node the server connects to?

Set the XRPL_NODE_URL environment variable to a valid XRPL JSON‑RPC endpoint. The default is Ripple’s public mainnet (https://s1.ripple.com:51234/).

Does the server submit real transactions by default?

Yes, when using the default endpoint, the submit_transaction tool broadcasts a signed transaction to the live XRP Ledger mainnet. For testing, set XRPL_NODE_URL to the XRPL testnet before launching.

What happens when a tool cannot find the requested data?

The server returns an MCP tool error with a descriptive message, e.g., “Account … not found on the ledger” for missing accounts or “Submitting transaction failed: …” for submission errors.

Does the server require any authentication or special transport?

No. It connects to the configured XRPL JSON‑RPC endpoint with no additional authentication, and communicates with the AI host via the standard MCP protocol (typically stdio).