XRPL

XRPL MCP is a dedicated server implementation that exposes XRP Ledger wallet management, token operations, NFT handling, and DEX trading through a comprehensive set of MCP tools. It enables you to interact with XRPL programmatically via MCP clients, performing complex actions with natural language requests and precise tool calls.

How to use

You connect an MCP client to XRPL MCP to start managing wallets, tokens, NFToken operations, and DEX activities. Use natural language prompts to invoke the available tools, monitor balances and transactions, create tokens, mint NFTs, and place or manage trading offers on XRPL. The MCP client handles the translation from your requests into the appropriate XRPL actions and returns structured results for review.

How to install

Prerequisites: you need Node.js and npm installed on your machine. You also need a Claude Desktop (or compatible MCP client) setup to connect to XRPL MCP.

Install the XRPL MCP global package so you can run the MCP client from anywhere.

Configure your MCP client to connect to XRPL MCP using the provided configuration snippet. This example uses npx to run the MCP client and passes your XRPL private key and network.

{
  "mcpServers": {
    "xrpl-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tamago-labs/xrpl-mcp",
        "--xrpl_private_key=YOUR_PRIVATE_KEY", 
        "--xrpl_network=mainnet"
      ],
      "disabled": false
    }
  }
}

Additional setup notes

If you are using a Linux environment with NVM, you may need to configure the path to the MCP client explicitly. The following example shows how to point to the Node binary and the MCP package directly.

{
  "mcpServers": {
    "xrpl-mcp": {
      "command": "/home/YOUR_NAME/.nvm/versions/node/YOUR_NODE_VERSION/bin/node",
      "args": [
        "/home/YOUR_NAME/.nvm/versions/node/YOUR_NODE_VERSION/bin/@tamago-labs/xrpl-mcp",
        "--xrpl_private_key=YOUR_PRIVATE_KEY",
        "--xrpl_network=mainnet"
      ]
    }
  }
}

Troubleshooting

If you encounter path-related issues on Linux with NVM, set up the MCP using absolute paths as shown in the steps below. After updating the config, restart your MCP client.

npm install -g @tamago-labs/xrpl-mcp

{
  "mcpServers": {
    "xrpl-mcp": {
      "command": "/home/YOUR_NAME/.nvm/versions/node/YOUR_NODE_VERSION/bin/node",
      "args": [
        "/home/YOUR_NAME/.nvm/versions/node/YOUR_NODE_VERSION/bin/@tamago-labs/xrpl-mcp",
        "--xrpl_private_key=YOUR_PRIVATE_KEY",
        "--xrpl_network=mainnet"
      ]
    }
  }
}

Available tools

xrpl_get_wallet_address

Retrieve your XRPL wallet address.

xrpl_get_account_info

Get detailed information about your XRPL account.

xrpl_get_balances

List all token balances held in your XRPL wallet.

xrpl_send_payment

Send XRP or tokens to another XRPL address with optional destination tags and memos.

xrpl_create_token

Create a new custom token with configurable settings and compliance options.

xrpl_set_trust_line

Establish or modify trust lines for token issuance and distribution.

xrpl_mint_nftoken

Mint a new non-fungible token with metadata and transfer settings.

xrpl_burn_nftoken

Burn an existing NFToken from your collection.

xrpl_create_offer

Create a trading offer on XRPL's built-in DEX.

xrpl_cancel_offer

Cancel an active trading offer.

xrpl_get_order_book

View the current order book for a trading pair on XRPL DEX.

xrpl_get_account_offers

List all active offers available in your account.

xrpl_get_transaction

Fetch detailed information about a specific transaction.

xrpl_get_recent_transactions

Retrieve recent transactions with analytics and history.

xrpl_get_account_info

View account status, balances, and trust lines in one place.