XRPL Agent Wallet

You can rely on XRPL Agent Wallet MCP to securely manage XRPL wallets for AI agents, enforce policies, and sign transactions with auditability. It uses a layered security model to keep master keys cold, apply policy-based decisions, and provide human oversight for high-risk actions, all while delivering a complete transaction history for compliance.

How to use

You interact with the MCP server through a client that can submit wallet-related requests, such as creating wallets, signing transactions within policy constraints, querying balances, and viewing or updating policies. The server enforces policy tiers, authenticates clients, and ensures all actions are logged for auditing. Start by configuring a client to point at one of the MCP endpoints you deploy, then perform wallet operations via the approved tools in a controlled sequence.

Typical usage patterns include creating a wallet, applying a policy, funding from a testnet faucet if needed, and signing transactions where the system will automatically determine if autonomous signing is allowed or if human approval is required. When high-value transactions are requested, you will be prompted to review and approve or veto based on the current policy and the risk assessment. Always review the destination, amount, and memo to prevent misuse.

How to install

Install the MCP server globally so you can run it from anywhere.

npm install -g xrpl-agent-wallet-mcp

Additional configuration and usage notes

Configure a client (Claude Desktop or any compatible MCP client) to load the wallet MCP server under the mcpServers section. Provide the network and master password to enable secure key handling and policy evaluation.

Example Claude Desktop configuration (JSON) to connect to the wallet MCP server on testnet uses a local stdio command. This keeps the master key secure and keys encrypted.

{
  "mcpServers": {
    "xrpl-wallet": {
      "command": "xrpl-agent-wallet-mcp",
      "env": {
        "XRPL_NETWORK": "testnet",
        "XRPL_WALLET_PASSWORD": "your-secure-password"
      }
    }
  }
}

Available tools

wallet_create

Create a new wallet with the configured policy and network context.

wallet_sign

Sign a transaction under policy control, enforcing tiered approvals when required.

wallet_balance

Query wallet balances and reserves to inform spending decisions.

wallet_policy_check

Evaluate a proposed action against current policy without executing it.

wallet_rotate

Rotate the regular key associated with a wallet.

wallet_list

List all wallets managed by the MCP server.

wallet_history

Retrieve the transaction history for a wallet.

wallet_fund

Fund a wallet from a testnet/devnet faucet or configured funding source.

policy_set

Update the deployed policy configuration for wallets and transactions.

tx_submit

Submit a signed transaction to the XRPL network.

tx_decode

Decode a raw transaction blob for inspection.