Used for environment variable management and configuration, allowing the server to securely store sensitive data like wallet seeds and network selection.
Serves as the runtime environment for the MCP server, with version 18.0.0 or higher required as a prerequisite.
Implementation language for the MCP server, providing type safety and modern language features.
Provides comprehensive blockchain services for the XRP Ledger ecosystem including account management, token operations, NFT operations, DID management, AMM operations, and transaction handling across MainNet, TestNet, and DevNet.
Used for TypeScript-first schema declaration and validation to ensure proper data formatting and validation for XRPL transactions.
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
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
⚙️ Server Configuration
Create a .env file in the project root with the following variables:
🚀 Usage
Starting the Server
Connecting to the Server
Connect to this MCP server using any MCP-compatible client. For testing and debugging, you can use the MCP Inspector.
📚 API Reference
Tools
The server provides the following MCP tools for agents:
Account Management
Tool Name | Description | Key Parameters |
| Connect to XRP Ledger using a seed | seed, network |
| Get account information | address, network |
| Delete an XRPL account | privateKey, destination, network |
| Set account properties | privateKey, properties, network |
| Preauthorize a deposit | privateKey, authorize, network |
| Set a regular key for an account | privateKey, regularKey, network |
XRP and Token Operations
Tool Name | Description | Key Parameters |
| Send XRP to an account | privateKey, to, amount, network |
| Get token metadata | tokenAddress, network |
| Check token balance | tokenAddress, ownerAddress, network |
| Transfer tokens | privateKey, tokenAddress, to, amount, network |
| Approve token spending | privateKey, tokenAddress, limit, network |
| Clawback tokens | privateKey, tokenAddress, from, amount, network |
NFT Operations
Tool Name | Description | Key Parameters |
| Mint an NFT | privateKey, uri, flags, network |
| Get NFT metadata | tokenID, network |
| Verify NFT ownership | tokenID, ownerAddress, network |
| Transfer an NFT | privateKey, tokenID, to, network |
| Get NFTs in a collection | address, network |
DID Operations
Tool Name | Description | Key Parameters |
| Create a DID | privateKey, data, network |
| Resolve a DID | did, network |
| Update a DID | privateKey, did, data, network |
| Deactivate a DID | privateKey, did, network |
AMM Operations
Tool Name | Description | Key Parameters |
| Create an AMM | privateKey, assets, network |
| Deposit to an AMM | privateKey, ammID, assets, network |
| Place bid on an AMM | privateKey, ammID, bid, network |
| Vote on AMM parameters | privateKey, ammID, vote, network |
| Delete an AMM | privateKey, ammID, network |
| Clawback assets from AMM | privateKey, ammID, assets, network |
Resources
The server exposes XRPL data through the following MCP resource URIs:
Ledger Resources
Resource URI Pattern | Description |
| Current ledger information |
| Ledger by index |
| Account information |
| Account XRP balance |
| Transaction details |
Token Resources
Resource URI Pattern | Description |
| Token information |
| Token balance |
| NFT information |
| NFT ownership information |
🔒 Security Considerations
Wallet seeds are used only for transaction signing and should be kept secure
Consider implementing additional authentication mechanisms for production use
For high-value services, consider adding confirmation steps
Default operations are performed on TestNet to ensure safety during development
Use environment variables for sensitive configuration
📁 Project Structure
🛠️ Development
Adding New Tools
To add a new tool:
Create a new TypeScript file in the appropriate directory under
src/transactions/Import the server from
server/server.jsDefine the tool using
server.tool()Import the tool in
src/index.ts
Project Dependencies
@modelcontextprotocol/sdk: MCP SDKxrpl: XRP Ledger JavaScript/TypeScript APIdotenv: Environment variable managementzod: TypeScript-first schema declaration and validation
📄 License
This project is licensed under the terms of the MIT License.
⚠️ Disclaimer
This software is provided for educational and development purposes only. Use it at your own risk. Always test thoroughly on the Testnet before using on Mainnet with real XRP.
This server cannot be installed