XRP Ledger Model Context Protocol Server

License: MIT | XRPL Networks | TypeScript | xrpl.js

A comprehensive Model Context Protocol (MCP) server that provides blockchain services for the XRP Ledger ecosystem. This server enables AI agents to interact with XRPL MainNet, TestNet, and DevNet with a unified interface.

📋 Contents

- Overview
- Features
- Supported Networks
- Prerequisites
- Installation
- Server Configuration
- Usage
- API Reference
- Security Considerations
- Project Structure
- Development
- License

🔭 Overview

The MCP XRPL Server leverages the Model Context Protocol to provide XRP Ledger services to AI agents. It supports a wide range of services including:

- Reading ledger state (balances, transactions, account info, etc.)
- Interacting with smart contracts (via Hooks)
- Transferring XRP and issued tokens
- Querying token metadata and balances
- Managing decentralized identifiers (DIDs)
- Working with NFTs on the XRPL
- Automated Market Maker (AMM) operations
- Payment channels, escrows, and checks
- Oracle data operations
- Trustline management

All services are exposed through a consistent interface of MCP tools and resources, making it easy for AI agents to discover and use XRPL functionality.

✨ Features

Account Management

- Connect to XRPL networks (MainNet, TestNet, DevNet)
- Account information retrieval
- Account property management
- Deposit preauthorization
- Regular key management

XRP and Token Operations

- Transfer XRP between accounts
- Get token metadata (name, symbol, decimals, supply)
- Check token balances
- Transfer tokens between addresses
- Approve token spending
- Token clawback

NFT Operations

- Mint NFTs on the XRP Ledger
- View NFT metadata
- Verify NFT ownership
- Transfer NFTs between addresses
- Get NFT collections

Decentralized Identifier (DID)

- Create DIDs on the XRPL
- Resolve DIDs
- Update DID documents
- Deactivate DIDs

AMM Operations

- Create Automated Market Makers
- Deposit to AMMs
- Place bids on AMMs
- Vote on AMM parameters
- Delete AMMs
- Clawback assets from AMMs

Check Operations

- Create checks
- Cash checks
- Cancel checks

Offer/DEX Operations

- Create offers
- Cancel offers

Oracle Operations

- Set oracle data
- Delete oracle data

Payment Channels

- Create payment channels
- Fund payment channels
- Claim from payment channels

Escrow

- Create escrows
- Finish escrows
- Cancel escrows

Trustlines

- Set and manage trustlines

Ticketing

- Create tickets for transaction processing

🌐 Supported Networks

- MainNet: Production XRP Ledger network
- TestNet: Test network for development
- DevNet: Development network for experimental features

🛠️ Prerequisites

- Node.js 18.0.0 or higher

📦 Installation

```bash