> For the complete documentation index, see [llms.txt](https://developers.shredpay.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.shredpay.xyz/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](/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](/agent-wallet/mcp-tools.md) — every tool and its parameters.
* [Gas Model](/agent-wallet/concepts/gas-model.md) — when ShredPay sponsors gas vs. when you pay.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://developers.shredpay.xyz/agent-wallet/quickstart/claude-desktop.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.