> 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/quickstart/claude-desktop.md).

# Claude Desktop

Wire ShredPay Agent Wallet into Claude Desktop in about three minutes. Claude will then be able to use all 17 wallet tools directly from any conversation.

## Prerequisites

* [Claude Desktop](https://claude.ai/download) installed (macOS or Windows).
* A ShredPay API key. If you don't have one, follow steps 1–2 of the [Direct API quickstart](/developers/agent-wallet/quickstart/direct-api.md).

## 1. Locate your Claude Desktop config

| OS      | Path                                                              |
| ------- | ----------------------------------------------------------------- |
| macOS   | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Windows | `%APPDATA%\Claude\claude_desktop_config.json`                     |

If the file doesn't exist, create it.

## 2. Add the ShredPay MCP server

```json
{
  "mcpServers": {
    "shredpay-wallet": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-fetch",
        "https://agent-api.shredpay.xyz/mcp"
      ],
      "env": {
        "X_API_KEY": "sk_live_..."
      }
    }
  }
}
```

Replace `sk_live_…` with your real key from the [Console](https://console.shredpay.xyz).

> The `@modelcontextprotocol/server-fetch` package is the simplest way to point Claude Desktop at a remote streamable-HTTP MCP server. If you maintain your own MCP client transport, point it directly at the `/mcp` endpoint with `X-Api-Key` set on every request.

## 3. Restart Claude Desktop

Fully quit and relaunch. After restart, click the tools icon at the bottom of the chat — you should see **shredpay-wallet** with 17 tools listed.

## 4. Ask Claude to use it

```
What's my USDC balance on Base?
```

Claude will call `get_wallet_address` and `get_balance` and answer with a number. Try follow-ups:

```
Show me my open DeFi positions.
Quote a swap of 50 USDC to ETH on Base.
What's my remaining daily spend limit?
```

Trade-permission tools (`send_transaction`, `execute_swap`, `defi_deposit`, `defi_withdraw`) only work if your key has `trade` enabled.

## Troubleshooting

| Symptom                                 | Fix                                                                                             |
| --------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Tools don't appear after restart        | Check the log at `~/Library/Logs/Claude/mcp*.log` (macOS) for JSON parse errors in your config. |
| `401 INVALID_KEY` in tool output        | Key was revoked or you copied a typo. Issue a new one in the console.                           |
| `403 PERMISSION_DENIED` on a write tool | Your key is `read` only. Create a `trade` key.                                                  |

## Next steps

* [MCP Tools reference](/developers/agent-wallet/mcp-tools.md) — every tool and its parameters.
* [Gas Model](/developers/agent-wallet/concepts/gas-model.md) — when ShredPay sponsors gas vs. when you pay.