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 installed (macOS or Windows).

• A ShredPay API key. If you don't have one, follow steps 1–2 of the Direct API quickstart.

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

{
  "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.

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 — every tool and its parameters.

• Gas Model — when ShredPay sponsors gas vs. when you pay.