For the complete documentation index, see llms.txt. This page is also available as Markdown.

Introduction

A custodial wallet purpose-built for AI agents. Agent Wallet lets your agent hold assets, sign transactions, swap tokens, and deposit into DeFi vaults — across six EVM chains — through a single REST or MCP interface.

Why a separate wallet for agents

Giving an LLM-powered agent direct access to a user's main wallet is reckless. Agent Wallet exists to make agent autonomy safe:

  • Isolated funds — Each agent gets its own sub-wallet, scoped per user. Compromise stays contained.

  • Hard spend caps — Per-key daily and monthly USD limits enforced server-side, before any signing.

  • Address screening — Every counterparty is checked against OFAC and risk lists on every write call.

  • Quorum signing — Two-of-two signatures (Privy + ShredPay co-signer) on every transaction. Neither party alone can move funds.

  • Per-chain whitelisting — Restrict a key to specific chains so a swap on Mainnet can't be triggered with a key meant for Base.

  • Killable — Revoke or rotate a key from the console without touching the wallet itself.

What it can do

Capability
REST
MCP

Read addresses, balances, limits

GET /api/wallet/*

get_wallet_address, get_balance, get_native_balance, get_token_balances, get_limits

Send arbitrary transactions

POST /api/tx/send

send_transaction

Simulate transactions

POST /api/tx/simulate

simulate_transaction

Quote and execute swaps

POST /api/swap/quote, /execute

get_swap_quote, execute_swap

DeFi vault deposit / withdraw

POST /api/defi/deposit, /withdraw

defi_deposit, defi_withdraw

Position and market discovery

GET /api/defi/markets, /positions

get_defi_markets, get_positions

Gas management (USDC → ETH)

POST /api/gas/swap, GET /api/gas/estimate

gas_swap, gas_estimate

Status lookup

GET /api/tx/{tx_id}

get_transaction_status

Chain discovery

GET /api/wallet/chains

get_supported_chains

That's the full surface — 17 MCP tools, all also available as REST endpoints.

Supported chains

Ethereum, Optimism, BNB Chain, Polygon, Base, Arbitrum. Always check GET /api/wallet/chains for the live list and to see which chains have ShredPay's Router contract deployed (Router-enabled chains support sponsored gas for swap and DeFi flows).

Pick a starting point

If you...
Go to

...want a working REST request right now

...are wiring up Claude Desktop

...are building on the OpenClaw platform

...want to understand the model first

Last updated