XRP Ledger
XRP Ledger MCP Server
What is XRP Ledger?
XRP Ledger is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to xrp ledger mcp server
XRP Ledger MCP Server
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- XRP Ledger MCP Server
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx xrplConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use XRP Ledger
The XRPL MCP Server is a Python package that exposes XRP Ledger JSON-RPC queries as MCP tools, allowing AI assistants to look up account balances, transaction history, NFTs, order book offers, and server status, as well as submit signed transactions. It connects to any XRP Ledger node via a configurable endpoint and defaults to the Ripple mainnet, with testnet support via environment variable.
Prerequisites
- Python 3.10 or newer
- pip for package installation
- An XRP Ledger node URL (defaults to https://s1.ripple.com:51234/ for mainnet, or use Ripple testnet)
- An XRP account address for account-specific queries (no private key required for read operations)
Install from PyPI
Install the XRPL MCP server package using pip. This is the recommended method.
pip install iflow-mcp_lgcarrier-xrpl-mcp-serverInstall from source (alternative)
Clone the repository and install in editable mode if you want to modify the server or run the latest development version.
git clone https://github.com/lgcarrier/xrpl-mcp-server.git
cd xrpl-mcp-server
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"Configure the XRP Ledger node URL
Set the XRPL_NODE_URL environment variable to point to your preferred node. Omit it to use the Ripple mainnet default.
# Mainnet (default — no variable needed)
export XRPL_NODE_URL="https://s1.ripple.com:51234/"
# Testnet
export XRPL_NODE_URL="https://s.altnet.rippletest.net:51234/"Register with Claude Desktop using mcp install
Use the built-in mcp install command to register the server with Claude Desktop automatically.
mcp install src/xrpl_mcp_server/server.py:mcp --with-editable .Or configure manually in claude_desktop_config.json
Add the server manually to your MCP client configuration, passing the node URL as an environment variable.
{
"mcpServers": {
"xrpl": {
"command": "python",
"args": ["-m", "xrpl_mcp_server.server"],
"env": {
"XRPL_NODE_URL": "https://s1.ripple.com:51234/"
}
}
}
}XRP Ledger Examples
Client configuration
claude_desktop_config.json entry for the XRPL MCP server connecting to the Ripple mainnet node.
{
"mcpServers": {
"xrpl": {
"command": "python",
"args": ["-m", "xrpl_mcp_server.server"],
"env": {
"XRPL_NODE_URL": "https://s1.ripple.com:51234/"
}
}
}
}Prompts to try
Use these prompts after connecting Claude to the XRPL MCP server to query ledger data.
- "What is the XRP balance and sequence number for account rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe?"
- "Show me the two most recent transactions for rPT1Sjq2YGrBMTttX4GZHjKu9dyfzbpAYe"
- "List all NFTs owned by account rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh"
- "Show me the first three book offers for XRP/USD on the XRPL DEX"
- "What is the current state of the XRP Ledger server — uptime, ledger version, and load?"Troubleshooting XRP Ledger
pip install fails with package not found
The PyPI package name is 'iflow-mcp_lgcarrier-xrpl-mcp-server' (with underscores and hyphens as shown). If it fails, install from source using the git clone method and 'pip install -e .'.
Connection errors when querying the ledger
Verify the XRPL_NODE_URL is reachable with 'curl https://s1.ripple.com:51234/' — it should return a JSON response. If on testnet, ensure the testnet URL 'https://s.altnet.rippletest.net:51234/' is correctly set.
submit_transaction returns an error
The submit_transaction tool requires a pre-signed transaction blob in hex format (tx_blob). Signing must be done externally using the xrpl-py library or a hardware wallet before calling this tool — the MCP server does not hold or manage private keys.
Frequently Asked Questions about XRP Ledger
What is XRP Ledger?
XRP Ledger is a Model Context Protocol (MCP) server that xrp ledger mcp server It connects AI assistants to external tools and data sources through a standardized interface.
How do I install XRP Ledger?
Follow the installation instructions on the XRP Ledger GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with XRP Ledger?
XRP Ledger works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is XRP Ledger free to use?
Yes, XRP Ledger is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
XRP Ledger Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to XRP Ledger? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
Browse More Finance & Fintech MCP Servers
Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up XRP Ledger in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use XRP Ledger?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.