XRP Ledger Testnet MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@XRP Ledger Testnet MCP Server get the XRP balance for address rPT1Sjq2YGrBMTttX4GZ9jRK9c6oXJ8mU"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
XRP Ledger Testnet MCP Server
✅ MBSS v3.0 Compliant - A comprehensive Model Context Protocol (MCP) server for XRP Ledger (XRPL) testnet integration with AI systems.
🎯 Quick Overview
Tool Count: 52 tools (25 MBSS mandatory + 27 XRP-specific)
Network: XRP Ledger Testnet (testnet-only server)
Architecture: MBSS v3.0 Unified Standard compliant
Test Coverage: 95%+ enforced with security & chaos testing
Help System: Interactive tool discovery and guidance
Performance: Production-ready with proper error handling
⚠️ Testnet Focus - Server is locked to XRP Ledger Testnet for safe development and testing.
Related MCP server: XRPL MCP Server
🏗️ Server Architecture
graph TB
A[AI Assistant] --> B[MCP Server]
B --> C[XRP Ledger Client]
C --> D[XRP Ledger Node]
B --> E[Help System]
B --> F[Tool Registry]
E --> G[Tool Discovery]
F --> H[Tool Execution]
subgraph "Core Components"
B
E
F
end
subgraph "External Services"
C
D
G
H
endComponent Legend:
MCP Server: Main server handling MCP protocol
XRP Ledger Client: XRPL network interaction via WebSocket
XRP Ledger Node: Blockchain node for data queries
Help System: Interactive tool discovery and guidance
Tool Registry: Centralized tool metadata management
✨ Key Features
🔗 Core XRP Ledger Operations
Chain Information - Network statistics, health, and configuration details
Balance Queries - XRP balances with formatted and raw values
Transaction Lookup - Detailed transaction analysis with fee data
Block Information - Ledger data with transaction counts and timestamps
Address Validation - Format validation and network verification
💼 Wallet Management
Wallet Creation - Generate new wallets (development/testing only)
Wallet Import - Import from seed phrases or keys
Account Information - Comprehensive wallet details and settings
Balance Monitoring - Real-time balance tracking
🪙 Payment & DEX Operations
XRP Payments - Send XRP with path finding and fee estimation
DEX Trading - Order book management and trade execution
Fee Estimation - Smart fee calculation for different transaction types
Testnet Funding - Automated test XRP requests for development
AMM Operations (1 tool)
xrp_get_amm_info - Query AMM pool details ✅
Token/Currency Operations (4 tools)
xrp_create_trustline - Establish trust line for token ✅
xrp_remove_trustline - Remove trust line (set limit to 0) ✅
xrp_get_trustlines - Get all trustlines for account ✅
xrp_send_token - Send issued tokens ✅
Escrow Operations (4 tools)
xrp_create_escrow - Create time/conditional escrow ✅
xrp_finish_escrow - Complete escrow with fulfillment ✅
xrp_cancel_escrow - Cancel expired escrow ✅
xrp_get_escrows - List account escrows ✅
NFT Operations (6 tools)
xrp_mint_nft - Create NFT (basic) ✅
xrp_mint_nft_with_ipfs - Create NFT with IPFS storage (Pinata/Web3.Storage) ✅ 🆕
xrp_burn_nft - Destroy NFT ✅
xrp_create_nft_offer - Create sell/buy offers ✅
xrp_accept_nft_offer - Accept NFT offer ✅
xrp_get_nfts - List account NFTs ✅
AI & Assistant Utilities (2 tools)
xrp_get_conversation_guidance - Contextual prompts for guided agent flows ✅
xrp_generate_nft_image - IPFS-ready image generation helper for NFT minting ✅
Network & Ledger Operations (7 tools)
xrp_get_ledger - Ledger information ✅
xrp_get_transaction - Transaction details ✅
xrp_get_server_info - Network status ✅
xrp_get_ledger_entry - Get specific ledger entry ✅
xrp_get_account_objects - Get account-owned objects ✅
xrp_subscribe - Real-time ledger updates ✅
xrp_decode_transaction - Decode transaction blob ✅
Implementation Status
✅ 40 tools fully implemented and tested
🚀 All core XRPL features supported
📝 Complete with examples and documentation
🚀 Installation
Prerequisites
Node.js: v18.0.0 or higher
npm: Latest stable version
Git: For cloning repository
Quick Start
# Clone the repository
git clone https://github.com/your-repo/xrp-testnet-mcp-server.git
cd xrp-testnet-mcp-server
# Install dependencies
npm install
# Build the server
npm run build
# Run with MCP Inspector for testing
npm run inspectConfiguration
Create a .env file in the root directory:
# Network Configuration
XRP_NETWORK=testnet
RPC_URL=wss://s.altnet.rippletest.net:51233
CHAIN_ID=NA
# Optional: IPFS configuration for NFT operations
PINATA_API_KEY=your_pinata_api_key
PINATA_SECRET_KEY=your_pinata_secret_key
IPFS_SERVICE=pinataMCP Integration
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"xrp-testnet": {
"command": "node",
"args": ["/path/to/xrp-testnet-mcp-server/dist/index.js"],
"cwd": "/path/to/xrp-testnet-mcp-server",
"env": {
"XRP_NETWORK": "testnet"
}
}
}
}Docker Support
# Build Docker image
docker build -t xrp-testnet-mcp-server .
# Run container
docker run -p 3000:3000 xrp-testnet-mcp-server📖 Usage Examples
Basic Operations
Get Network Information
{
"tool": "xrp_get_chain_info",
"arguments": {}
}Check Balance
{
"tool": "xrp_get_balance",
"arguments": {
"address": "rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH"
}
}Create Wallet (Development Only)
{
"tool": "xrp_create_wallet",
"arguments": {}
}Advanced Workflows
Complete Transaction Flow
Check balance:
{
"tool": "xrp_get_balance",
"arguments": {
"address": "rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH"
}
}Send payment:
{
"tool": "xrp_send_transaction",
"arguments": {
"to": "rB7ASwFaJ2ryXUDUN8ViiVWba1ikXcqFxB",
"amount": "10",
"seed": "your_wallet_seed"
}
}AI Integration Examples
Claude Desktop Integration
{
"tool": "xrp_help",
"arguments": {
"topic": "balance_queries"
}
}Tool Discovery
{
"tool": "xrp_search_tools",
"arguments": {
"query": "balance"
}
}🛠️ Complete Tool Reference
MBSS v3.0 Core Tools (25 Mandatory)
1. xrp_get_chain_info
Get comprehensive XRP Ledger network information.
Purpose: Network health, statistics, and configuration details
Parameters: None
Returns:
{
"network": "string",
"ledgerVersion": "number",
"fee": "string",
"reserves": "object",
"validatedLedger": "object",
"serverInfo": "object"
}2. xrp_get_balance
Get XRP balance for an address.
Purpose: Query account balances with formatted and raw values
Parameters:
address(string, required): XRP Ledger address
Returns:
{
"address": "string",
"balance": "string",
"balanceRaw": "string",
"symbol": "XRP",
"reserves": "string"
}3. xrp_get_transaction
Get detailed transaction information by hash.
Purpose: Transaction analysis with fee and validation data
Parameters:
hash(string, required): Transaction hash
Returns:
{
"hash": "string",
"validated": "boolean",
"ledgerIndex": "number",
"account": "string",
"destination": "string",
"amount": "string",
"fee": "string",
"meta": "object"
}XRP-Specific Tools (29 Additional)
NFT Operations (6 tools)
xrp_mint_nft: Create basic NFT
xrp_mint_nft_with_ipfs: Create NFT with IPFS storage
xrp_burn_nft: Destroy NFT
xrp_create_nft_offer: Create sell/buy offers
xrp_accept_nft_offer: Accept NFT offer
xrp_get_nfts: List account NFTs
Token/Currency Operations (4 tools)
xrp_create_trustline: Establish trust line for token
xrp_remove_trustline: Remove trust line
xrp_get_trustlines: Get all trustlines for account
xrp_send_token: Send issued tokens
Escrow Operations (4 tools)
xrp_create_escrow: Create time/conditional escrow
xrp_finish_escrow: Complete escrow with fulfillment
xrp_cancel_escrow: Cancel expired escrow
xrp_get_escrows: List account escrows
DEX & AMM Operations (5 tools)
xrp_place_order: Create buy/sell orders
xrp_cancel_order: Cancel existing orders
xrp_get_orderbook: Get order book data
xrp_get_order_history: Get trading history
xrp_get_amm_info: Query AMM pool details
Network & Ledger Operations (7 tools)
xrp_get_ledger: Ledger information
xrp_get_server_info: Network status
xrp_get_ledger_entry: Get specific ledger entry
xrp_get_account_objects: Get account-owned objects
xrp_subscribe: Real-time ledger updates
xrp_decode_transaction: Decode transaction blob
xrp_request_faucet: Request testnet XRP
AI & Assistant Utilities (2 tools)
xrp_get_conversation_guidance: Contextual prompts for guided flows
xrp_generate_nft_image: IPFS-ready image generation helper
Account & Wallet Management (1 additional)
xrp_get_account_info: Comprehensive account details
🌐 Supported Networks
Primary Network
XRP Ledger Testnet (Chain ID: N/A)
Purpose: Primary XRP Ledger test network for development and testing
Block Time: ~3-5 seconds
Consensus: Ripple Protocol Consensus Algorithm (RPCA)
Native Token: XRP (Ripple)
Additional Networks
XRP Ledger Devnet: Alternative testing network with controlled features
Testnet Faucets
Official XRPL Faucet: https://faucet.altnet.rippletest.net/
XRPL Dev Portal: https://xrpl.org/xrp-testnet-faucet.html
RPC Endpoints
Primary: wss://s.altnet.rippletest.net:51233
Backup: wss://testnet.xrpl-labs.com
WebSocket: wss://s.altnet.rippletest.net:51233
Environment Variables
XRP_NETWORK- Set totestnetordevnet(defaults to testnet)PINATA_API_KEY- Pinata API key for IPFS uploadsPINATA_SECRET_KEY- Pinata secret key for IPFS uploadsIPFS_SERVICE- IPFS service to use (pinata | web3Storage | nftStorage)
Testnet Resources
Testnet Explorer: https://testnet.xrpl.org/
Testnet WebSocket: wss://s.altnet.rippletest.net:51233
Devnet Explorer: https://devnet.xrpl.org/
XRPL Dev Tools: https://xrpl.org/dev-tools.html
IPFS Integration for NFTs 🆕
The server now supports decentralized NFT storage via IPFS using Pinata, Web3.Storage, or NFT.Storage.
Setting up IPFS Storage
Get a Pinata Account (Recommended)
Sign up at pinata.cloud
Get 1GB free storage (50% off with code NFTSTORAGE50)
Create API keys in dashboard
Configure Environment
# .env file PINATA_API_KEY=your_api_key PINATA_SECRET_KEY=your_secret_key IPFS_SERVICE=pinataUse the Enhanced NFT Tool
// Tool #37: xrp_mint_nft_with_ipfs { "seed": "your_wallet_seed", "name": "My NFT", "description": "NFT with IPFS storage", "imageUrl": "https://example.com/image.jpg", "attributes": [ { "trait_type": "Rarity", "value": "Legendary" } ], "flags": 8, // 8 = transferable "transferFee": 1000 // 1% royalty }
IPFS Benefits
✅ Permanent, decentralized storage
✅ No single point of failure
✅ Content-addressed (tamper-proof)
✅ Globally accessible via any IPFS gateway
✅ Metadata and images stored separately
Conversational Usage Examples
Example 1: Quick NFT with Stock Image
User: "Create an NFT called 'Majestic Eagle' with a bald eagle image"
Assistant: "I'll create that NFT for you. Let me use a stock image of a bald eagle:"
// Uses Unsplash or similar stock photo
await xrp_mint_nft_with_ipfs({
seed: "your_wallet_seed",
name: "Majestic Eagle",
description: "A powerful bald eagle soaring through the sky",
imageUrl: "https://images.unsplash.com/photo-[eagle-id]",
attributes: [
{ trait_type: "Species", value: "Bald Eagle" },
{ trait_type: "Rarity", value: "Legendary" }
]
})Example 2: NFT with Your Own Image
User: "I have an image at https://mysite.com/art.jpg - make it an NFT with cool metadata"
Assistant: "I'll mint that as an NFT with enhanced metadata:"
await xrp_mint_nft_with_ipfs({
seed: "your_wallet_seed",
name: "Custom Artwork",
imageUrl: "https://mysite.com/art.jpg",
// Auto-generates rich metadata
})Example 3: Detailed NFT Request
User: "Create an NFT of a cyberpunk dragon with these traits: Element=Fire, Rarity=Mythic, Power=9000"
Assistant: "I'll create that NFT with all specified traits:"
Finds appropriate dragon image from stock photos
Uploads to IPFS via Pinata
Creates metadata with all traits
Mints on XRP Ledger
Returns IPFS links and transaction hash
Image Sources
Stock Photo APIs (current):
Unsplash: Free, high-quality photos
Pexels: Free stock photos
Pixabay: Free images and illustrations
User-Provided URLs:
Any public image URL
Cloud storage links (Dropbox, Google Drive public links)
IPFS URLs (already decentralized)
Future Enhancements:
AI image generation (DALL-E, Stable Diffusion)
Direct file uploads
Image search integration
Tool Documentation
xrp_get_account_info
Query account details and balances on testnet.
Parameters:
address(string): XRP Ledger address
Example:
{
"address": "rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH"
}xrp_send_payment
Send XRP or tokens on testnet.
Parameters:
destination(string): Recipient addressamount(string): Amount to sendcurrency(string, optional): Currency code (default: XRP)
Example:
{
"destination": "rN7n7otQDd6FczFgLdSqtcsAUxDkw6fzRH",
"amount": "10",
"currency": "XRP"
}xrp_place_order
Create buy/sell orders on the testnet DEX.
Parameters:
side(string): "buy" or "sell"amount(string): Order amountprice(string): Order pricepair(string): Trading pair
Example:
{
"side": "buy",
"amount": "100",
"price": "0.5",
"pair": "USD/XRP"
}For complete tool documentation with parameters and examples, use the MCP Inspector or refer to the source code.
XRP Ledger Testnet Advantages
Native DEX Testing: Test the world's oldest DEX operating since 2012
Native AMM: Test protocol-level automated market makers
Built-in Escrow: Test time-based and conditional escrow without smart contracts
Payment Channels: Test micropayment infrastructure for high-frequency transactions
Fast Settlement: 3-5 seconds for rapid development iteration
Low Fees: Fraction of a cent per transaction (even lower on testnet)
Energy Efficient: Minimal environmental impact for extensive testing
Multi-signing: Test native multi-signature support
Testnet Native Features
Unlike Ethereum-based chains that require smart contracts, XRPL testnet provides:
Built-in DEX with auto-bridging for comprehensive testing
Native AMM functionality without external protocols
Escrow system without contract deployment
Payment channels for micropayment testing
Multi-signature transactions for security testing
Token issuance and management with native commands
Testnet Security & Development
⚠️ TESTNET WARNINGS:
No Real Value: Testnet tokens have no monetary value
Network Resets: Testnet may be reset, wiping all data
Experimental Features: Latest features may be unstable
Rate Limits: Testnet servers may have stricter rate limits
Development Best Practices
Test All Features: Thoroughly test DEX, AMM, and escrow functionality
Account Management: Test both funded and unfunded account scenarios
Transaction Fees: Monitor fee escalation during network stress
Sequence Numbers: Test transaction ordering and ticket usage
Trust Lines: Test token issuance and trust relationships
Development
# Development mode
npm run dev
# Build TypeScript
npm run build
# Run tests
npm testTechnical Details
Language: TypeScript
Framework: xrpl.js v4.4.0
Architecture: MCP Server Protocol
Networks: Testnet/Devnet support
Performance: 1,500 TPS, 3-5 second settlement
Consensus: Unique consensus algorithm (not PoW or PoS)
Environment: Testnet/Development only
🔒 Security & Best Practices
⚠️ Critical Security Notes
Testnet Only: This server is configured for XRP Ledger testnet only
No Private Key Storage: Server never stores private keys or seeds
Development Tools: Wallet creation tools are for development/testing only
Network Verification: Always verify network before transactions
🛡️ Security Features
Input Validation: All inputs validated with Zod schemas
Error Sanitization: Error messages don't expose sensitive data
Rate Limiting: Built-in rate limiting protection
Multi-network Isolation: Testnet/devnet/mainnet environment separation
Security Testing: Comprehensive injection and XSS protection
Chaos Testing: Fault tolerance and failure recovery testing
Private Key Protection: No private key storage or logging
📋 Best Practices
Test First: Always test transactions on testnet
Verify Addresses: Double-check recipient addresses
Fee Management: Monitor transaction fees and reserves
Backup Recovery: Keep wallet seeds secure
Network Selection: Use appropriate network for your use case
🚨 Security Warnings
Private Key Exposure: Never share or log private keys or seeds
Faucet Limits: Testnet faucets have rate limits
Transaction Confirmation: Wait for ledger validation before considering transactions final
Trust Line Risks: Verify issuer addresses before creating trust lines
🔧 Troubleshooting
Common Issues
Connection Problems
Problem: "Failed to connect to XRP Ledger" Solution:
Verify WebSocket URL in environment variables
Check network connectivity
Try alternative XRP Ledger nodes
Ensure testnet node is accessible
Tool Not Found
Problem: "Unknown tool: xrp_tool_name" Solution:
Verify tool name spelling
Check MBSS naming convention
Use
xrp_helpfor tool discoveryUpdate MCP server configuration
Balance Returns Zero
Problem: "Balance shows 0 for valid address" Solution:
Verify address format and network
Check if address is activated (20 XRP reserve)
Use testnet faucet if needed
Wait for ledger synchronization
Account Not Found
Problem: "Account not found error" Solution:
Account may not be activated
Fund account with at least 20 XRP
Use
xrp_request_faucetfor testnet XRPVerify address format
Error Messages
Invalid address format: Check address format and networkAccount not activated: Fund account with minimum reserve (20 XRP)Insufficient XRP balance: Add funds to wallet or use faucetTrust line not found: Create trust line before token operationsFee exceeds available balance: Ensure sufficient XRP for transaction fees
Getting Help
Use
xrp_helpfor interactive assistanceUse
xrp_search_toolsto find relevant toolsCheck this README for examples
Review error logs in server output
🏗️ Technical Architecture
System Components
Language: TypeScript with strict type checking
Framework: Model Context Protocol (MCP) SDK
Validation: Zod schema validation for all inputs
Testing: Jest with 95%+ coverage, security & chaos tests
Build System: TypeScript compiler with ES2022 target
Architecture: MBSS v3.0 compliant modular design
Dependencies
{
"@modelcontextprotocol/sdk": "^1.0.0",
"zod": "^3.22.0",
"xrpl": "^4.4.0",
"axios": "^1.7.0",
"uuid": "^10.0.0"
}File Structure
src/
├── index.ts # Main server entry point
├── client.ts # XRP Ledger client abstraction
├── constants.ts # Configuration constants
├── logger.ts # MBSS-compliant logging
├── types.ts # TypeScript type definitions
├── tools/ # Organized tool modules
│ ├── core/ # MBSS v3.0 mandatory tools (25)
│ ├── wallet/ # Wallet management tools
│ ├── tokens/ # Token operations
│ ├── nft/ # NFT operations
│ ├── escrow/ # Escrow operations
│ ├── dex/ # DEX trading tools
│ ├── amm/ # AMM operations
│ ├── advanced/ # Advanced features
│ ├── special/ # AI utilities
│ └── help/ # Help system tools
└── utils/ # Shared utilitiesPerformance Characteristics
Response Time: <5 seconds for standard operations
Concurrent Requests: Up to 10 simultaneous requests
Memory Usage: ~50MB base + ~10MB per active connection
Network: Optimized WebSocket connections with reconnection
Test Coverage: 95%+ enforced with comprehensive testing
Security: Input validation, injection protection, chaos testing
Ledger Settlement: 3-5 seconds for transaction validation
Consensus: Unique RPCA algorithm (not PoW or PoS)
License
MIT
Available Tools
51 toolsxrp_accept_nft_offerA
Accept an NFT buy or sell offer
Inputs: offer_id (required), privateKey (required).
xrp_approve_tokenC
Set token spending authorization (trustline management)
Inputs: limit (required), issuer (required), currency (required), privateKey (required).
xrp_burn_nftB
Burn an NFT you own
Inputs: nft_id (required), privateKey (required).
xrp_cancel_escrowB
Cancel an expired escrow
Inputs: owner (required), privateKey (required), escrow_sequence (required).
xrp_cancel_orderB
Cancel an existing DEX order
Inputs: privateKey (required), offer_sequence (required).
xrp_create_escrowB
Create time or condition-locked escrow
Inputs: amount (required), privateKey (required), destination (required), condition, +2 more.
xrp_create_nft_offerB
Create buy or sell offer for NFT
Inputs: amount (required), nft_id (required), privateKey (required), flags, +1 more.
xrp_create_trustlineB
Create a trustline to hold a custom token
Inputs: limit (required), issuer (required), currency (required), privateKey (required).
xrp_create_walletB
Generate new XRP wallet with address and keys
Inputs: no named parameters.
xrp_decode_transactionB
Decode a transaction blob
Inputs: tx_blob (required).
xrp_estimate_feesC
Estimate transaction fees for different transaction types
Inputs: transactionType.
xrp_finish_escrowB
Complete an escrow and release funds
Inputs: owner (required), privateKey (required), escrow_sequence (required), fulfillment.
xrp_fund_testnet_accountA
Fund a testnet account with test XRP
Inputs: address (required).
xrp_generate_addressC
Generate new XRP addresses with optional derivation paths
Inputs: count.
xrp_generate_nft_imageB
Generate AI image for NFT using free APIs (FLUX.1, Stable Diffusion, Playground AI)
Inputs: prompt (required), style, quality, aspectRatio.
xrp_get_account_infoB
Get complete account information including balance and settings
Inputs: address (required).
xrp_get_account_objectsC
Get all objects owned by an account
Inputs: address (required), type.
xrp_get_amm_infoC
Get info about an AMM pool
Inputs: asset1 (required), asset2 (required).
xrp_get_balanceB
Get XRP balance for an address
Inputs: address (required).
xrp_get_blockB
Get ledger (block) information by number
Inputs: blockNumber.
xrp_get_chain_infoC
Get comprehensive XRP Ledger information including network status
Inputs: no named parameters.
xrp_get_conversation_guidanceB
Get conversation prompts and guidance for specific XRP operations
Inputs: operation (required), user_request.
xrp_get_escrowsB
Get all escrows for an account
Inputs: address (required).
xrp_get_gas_priceA
Get current transaction fee (gas) pricing in drops
Inputs: no named parameters.
xrp_get_ledger_entryB
Get specific ledger entry by ID
Inputs: index, accounts, ledger_hash, ledger_index.
xrp_get_mempool_infoA
Get open ledger (mempool) transaction statistics
Inputs: no named parameters.
xrp_get_network_infoB
Get current XRP Ledger network configuration and connection status
Inputs: no named parameters.
xrp_get_nftsB
Get all NFTs owned by an account
Inputs: address (required).
xrp_get_offersC
Get open offers for an account
Inputs: address (required).
xrp_get_order_bookC
Get order book depth for a currency pair
Inputs: taker_gets (required), taker_pays (required), limit.
xrp_get_token_allowanceB
Get token trustline limit (spending allowance)
Inputs: issuer (required), address (required), currency (required).
xrp_get_token_balanceA
Get custom token (trustline) balance for an account
Inputs: issuer (required), address (required), currency (required).
xrp_get_token_infoC
Get token metadata and issuer information
Inputs: issuer (required), currency (required).
xrp_get_transactionB
Get transaction details by hash
Inputs: hash (required).
xrp_get_transaction_historyC
Get transaction history for an address
Inputs: address (required), limit.
xrp_get_trustlinesA
Get all trustlines for an account
Inputs: address (required).
xrp_get_wallet_infoC
Get comprehensive wallet information including balance, nonce, and transaction count
Inputs: address (required).
xrp_helpC
Get help and guidance for XRP MCP tools
Inputs: topic.
xrp_import_walletB
Import an existing XRP wallet from seed
Inputs: seed (required).
xrp_list_tools_by_categoryC
List tools organized by category
Inputs: category, includeDescriptions.
xrp_mint_nftC
Mint a new NFT on XRP Ledger
Inputs: uri (required), privateKey (required), flags, taxon, +1 more.
xrp_mint_nft_with_ipfsB
Create NFT with IPFS storage for images and metadata (Enhanced version of xrp_mint_nft)
Inputs: name (required), privateKey (required), description (required), flags, +6 more.
xrp_place_orderC
Place a buy or sell order on the DEX
Inputs: privateKey (required), taker_gets (required), taker_pays (required).
xrp_remove_trustlineB
Remove a trustline (set limit to 0)
Inputs: issuer (required), currency (required), privateKey (required).
xrp_search_toolsC
Search available tools by keyword
Inputs: query (required), limit.
xrp_send_tokenC
Send custom token to another account
Inputs: amount (required), issuer (required), currency (required), privateKey (required), +1 more.
xrp_send_transactionB
Send XRP to another address
Inputs: to (required), amount (required), privateKey.
xrp_set_account_settingsC
Configure account settings (transfer fees, flags, etc)
Inputs: privateKey (required), domain, email_hash, message_key, +3 more.
xrp_subscribeB
Subscribe to real-time ledger updates
Inputs: streams (required), accounts.
xrp_transfer_tokenC
Transfer custom tokens between accounts
Inputs: amount (required), issuer (required), currency (required), privateKey (required), +1 more.
xrp_validate_addressB
Validate XRP address format
Inputs: address (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 51 tools
Several tools have nearly identical purposes, such as send_token vs transfer_token, get_wallet_info vs get_account_info, get_chain_info vs get_network_info, and get_gas_price vs estimate_fees. Even with descriptions, these overlaps make it difficult for an agent to reliably pick the right tool.
All tool names follow the same xrp_ prefix with snake_case and a consistent verb_noun structure (e.g., xrp_create_escrow, xrp_finish_escrow, xrp_cancel_escrow). No mixing of conventions, making the naming highly predictable.
With 51 tools, the server is overstuffed. Many tools are redundant variants of the same operation (e.g., send_token/transfer_token, mint_nft/mint_nft_with_ipfs), inflating the count without adding genuine functionality. A leaner set would be more effective.
The toolset covers major XRP Ledger areas (wallets, transactions, escrow, DEX, NFTs, tokens), but missing key operations like AMM creation/swapping, payment channels, and checks. The redundancy doesn't address these gaps, leaving notable holes in advanced functionality.
Maintenance
Related MCP Connectors
Escrow for AI agents on the XRP Ledger. 51 tools. Free testnet sandbox (no real XRP).
XRPL token rug-checks, issuer reputation & AMM data for AI agents. Pay-per-call USDC via x402.
Trustless XRPL escrow oracle for AI agents. Create jobs, verify work, release XRP/RLUSD payments.
XRPL data tools for AI agents: wallet classifier, signals, RWA tracker, ETF flows. Pay via x402.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA 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.4-
- AlicenseNot gradedqualityDmaintenanceA bridge that enables AI models like Claude and GPT to access XRP Ledger data and functionality through a standardized API interface.11MIT
- AlicenseNot gradedqualityDmaintenanceCP server that provides integration with the XRP Ledger. The server allows AI assistants to access account information, transaction history, and network data on the XRP Ledger, with capabilities for querying ledger objects, submitting transactions, and monitoring the network.13MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with XRP Ledger blockchain for managing wallets, creating and trading tokens, minting and managing NFTs, and executing DEX trades through 15+ comprehensive tools.7 npm2MIT