Tool	Pays	Description
`proxy_get`	~$0.003	Fetch a URL through residential IP (2MB cap, sticky by default)
`create_session`	~$0.50	Buy a 30/60‑min session pass + ephemeral CONNECT credentials (~250MB)
`extend_session`	~$0.50	Top up TTL/byte cap without changing exit IP
`close_session`	free	Revoke credentials early (no automatic refund in MVP)

Every request to the proxy API includes X-Client-Source: mcp for channel attribution.

Install / Claude Desktop

Add to your Claude Desktop MCP config (claude_desktop_config.json):

{
  "mcpServers": {
    "aproxproxy": {
      "command": "npx",
      "args": ["-y", "aproxproxy-mcp"],
      "env": {
        "APROXPROXY_PRIVATE_KEY": "0xYOUR_BUYER_PRIVATE_KEY",
        "APROXPROXY_BASE_URL": "https://proxy.aproxpay.com"
      }
    }
  }
}

Then ask Claude to call proxy_get with url: "https://example.com".

Environment

Variable	Required	Default	Notes
`APROXPROXY_PRIVATE_KEY`	yes	—	`0x` + 64 hex chars. Signs x402 payments. Never commit.
`APROXPROXY_BASE_URL`	no	`https://proxy.aproxpay.com`	Point at local proxy for testnet: `http://localhost:8080`
`APROXPROXY_HTTP_PORT`	no	`3100`	Only used with `--http`
`APROXPROXY_HTTP_HOST`	no	`127.0.0.1`	Only used with `--http`

Testnet smoke

Run the AproxPay proxy locally on base-sepolia.
Fund a buyer wallet from the Circle faucet.
Set APROXPROXY_BASE_URL=http://localhost:8080 and the testnet private key.
Call proxy_get.

Transports

stdio (default) — local agents / Claude Desktop: npx -y aproxproxy-mcp
Streamable HTTP (self-hosted) — npx -y aproxproxy-mcp --http listens on http://127.0.0.1:3100/mcp

Remote HTTP is self-hosted only. The payment private key must stay on the operator's machine. AproxPay does not host a shared remote MCP endpoint (that would be custodial).

Security notes

Prefer a dedicated low-balance buyer wallet for the MCP server.
Do not put mainnet keys in chat logs or screenshots.
close_session does not refund: x402 exact-scheme settlements are irreversible; manual refunds go through admin.