XRP Ledger

by lgcarrier

6 stars

324 downloads

Not rated

GitHub

About

Provides direct access to XRP Ledger data and functionality, enabling querying account information, transaction history, and submitting signed transactions to the network.

Details

Author: lgcarrier
Repository: lgcarrier/xrpl-mcp-server
GitHub stars: 6
Downloads: 324
Categories: AI, Design, Developer Tools, Search, Frontend, Infrastructure, Knowledge Base, Other

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name XRP Ledger

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 @highlight/mcp-server
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "xrp ledger": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "xrp ledger": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "xrp ledger": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "xrp ledger": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "xrp ledger": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "xrp ledger": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "xrp ledger": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "xrp ledger": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "xrp ledger": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "xrp ledger": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "xrp ledger": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "xrp ledger": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "xrp ledger": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

JSON

{
    "mcpServers": {
        "xrp ledger": {
            "env": {},
            "args": [
                "/c",
                "npx",
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "cmd"
        }
    }
}

JSON

{
    "mcpServers": {
        "xrp ledger": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

From the repository

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?

xrpl-mcp-server

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

If you prefer uv, the equivalent commands are uv run mcp dev ... and uv run mcp install ....

`get_account_info`

Retrieve information about an XRP Ledger account. Parameters: address (string): XRP Ledger account address.

`get_account_lines`

Query trust lines associated with an XRP Ledger account. Parameters: address (string): XRP Ledger account address, peer (string, optional): Counterparty account filter, limit (integer, optional): Maximum number of trust lines.

`get_account_nfts`

Fetch the NFTs owned by an XRP Ledger account. Parameters: address (string): XRP Ledger account address, limit (integer, optional): Maximum number of NFTs.

`get_account_transactions`

Retrieve the transaction history for an XRP Ledger account. Parameters: address (string): XRP Ledger account address, limit (integer, optional): Maximum number of transactions, binary (boolean, optional): Return transactions in binary form, forward (boolean, optional): Search forward through ledger history.

`get_server_info`

Get the current status and information of the XRPL server.

`submit_transaction`

Submit a signed transaction to the XRP Ledger. Parameters: tx_blob (string): Signed transaction blob in hex format.

`get_transaction_info`

Retrieve information about a specific transaction. Parameters: transaction_hash (string): Transaction hash.

`get_book_offers`

Inspect the DEX order book offers. Parameters: taker_gets (object): Currency/issuer object the taker wants to receive, taker_pays (object): Currency/issuer object the taker wants to pay, limit (integer, optional): Maximum number of offers.

All tools keep their existing names and arguments. Successful calls return structured MCP outputs instead of plain text or JSON-encoded strings.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "xrp ledger": {
            "env": {},
            "args": [
                "-y",
                "@highlight/mcp-server"
            ],
            "command": "npx"
        }
    }
}

Linux

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Macos

{
    "env": [],
    "args": [
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "npx"
}

Windows

{
    "env": [],
    "args": [
        "/c",
        "npx",
        "-y",
        "@highlight/mcp-server"
    ],
    "command": "cmd"
}

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

Package Chooser

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

| Package | PyPI | Install | Use when |
| --- | --- | --- | --- |
| Published package | | python -m pip install iflow-mcp_lgcarrier-xrpl-mcp-server | Recommended if you want the packaged CLI/server immediately and do not need an editable checkout. |
| Source checkout | — | python -m pip install -e ".[dev]" | You are developing in this repo, running tests, or using the local mcp dev / mcp install workflows below. |

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

python -m xrpl_mcp_server

Run as an installed package

xrpl-mcp-server

Inspect locally with the MCP Inspector

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

Install into Claude Desktop

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

If you prefer uv, the equivalent commands are uv run mcp dev ... and uv run mcp install ....

Available Tools

All tools keep their existing names and arguments. Successful calls return structured MCP outputs instead of plain text or JSON-encoded strings.

`get_account_info`

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

get_account_info

get_account_lines

get_account_nfts

get_account_transactions

get_server_info

submit_transaction

get_transaction_info

get_book_offers

Claude Desktop / Cursor

Linux

Macos

Windows

XRPL MCP Server

Requirements

Features

Package Chooser

Quickstart

Installation

From source

From PyPI

Configuration

Safety Note

Usage

Run directly from source

Run as an installed package

Inspect locally with the MCP Inspector

Install into Claude Desktop

Available Tools

get_account_info

Install

More like this

Sentry

Github

Git

GitLab

Context 7

1Panel

`get_account_info`

`get_account_lines`

`get_account_nfts`

`get_account_transactions`

`get_server_info`

`submit_transaction`

`get_transaction_info`

`get_book_offers`

`get_account_info`