> For the complete documentation index, see [llms.txt](https://docs.shredpay.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shredpay.xyz/developers/agent-wallet/introduction.md).

# 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](https://modelcontextprotocol.io/) 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 | [Direct API quickstart](/developers/agent-wallet/quickstart/direct-api.md)         |
| ...are wiring up Claude Desktop          | [Claude Desktop quickstart](/developers/agent-wallet/quickstart/claude-desktop.md) |
| ...are building on the OpenClaw platform | [OpenClaw quickstart](/developers/agent-wallet/quickstart/openclaw.md)             |
| ...want to understand the model first    | [Sub-wallets](/developers/agent-wallet/concepts/sub-wallets.md)                    |