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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.shredpay.xyz/agent-wallet/introduction.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.