XRPL MCP Service

A Model Context Protocol (MCP) server providing comprehensive access to the XRP Ledger (XRPL). This service enables AI models to interact with XRPL through standardized endpoints.

Features

Account Information

• xrpl_account_info - Basic account details

• xrpl_account_balances - XRP and token balances (human-readable)

• xrpl_account_lines - Trust lines

• xrpl_account_offers - Active trading offers

• xrpl_account_nfts - NFT holdings

• xrpl_account_tx - Transaction history

Decentralized Exchange

• xrpl_order_book - View order book for currency pairs

• xrpl_market_price - Get current market prices

• xrpl_amm_info - Automated Market Maker information

NFT Operations

• xrpl_nft_offers - View NFT buy/sell offers

Trust Lines & Payments

• xrpl_set_trust_line - Establish new trust lines

• xrpl_remove_trust_line - Remove existing trust lines

• xrpl_payment_channels - Payment channel information

• xrpl_find_path - Payment path finding

• xrpl_deposit_auth - Check payment authorization

System

• xrpl_server_info - Node status and information

• xrpl_submit_tx - Submit signed transactions

Related MCP server: XTBApiServer

Setup

1. Create a .env file:

2. Install dependencies:

3. Run the server:

API Usage Examples

Get Account Info

Get Account Balances

Set Trust Line

Get AMM Info

Get Market Price

Project Structure

Key Components

1. xrpl_tools.py

   • Core XRPL interaction functions

   • Async implementation with event loop handling

   • Error handling and response formatting

2. register_tools.py

   • MCP tool registration

   • Endpoint mapping and configuration

Future Enhancements

1. AMM (Liquidity Pool) Operations

   • Create pools

   • Add/remove liquidity

   • Vote on pool parameters

2. Advanced Trading

   • Create/cancel offers

   • Automated trading functions

   • Price alerts

3. NFT Operations

   • Mint NFTs

   • Create/accept offers

   • Collection management

Common Issues

1. Async Event Loop: If you see "asyncio.run() cannot be called from a running event loop", check the async implementation in xrpl_tools.py

2. Rate Limiting: Consider implementing rate limiting for production use

Contributing

1. Fork the repository

2. Create a feature branch

3. Implement your changes

4. Submit a pull request

Important Notes

• Always use "validated" ledger for production

• Secure wallet seeds and private keys

• Monitor transaction fees

• Test thoroughly on testnet first

Resources

• XRPL Documentation

• MCP Protocol Docs

• FastAPI Documentation

License

MIT