Payfetch MCP Server

by forum-labsio.github.forum-labs/payfetchv1.0.0

Non-custodial paying fetch for x402 APIs (USDC on Base) with operator-set spend caps, approval thresholds, allow/deny lists and a receipt for every attempt.

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained3mo ago

Install Payfetch MCP server

claude mcp add payfetch -e PAYFETCH_PRIVATE_KEY='<payfetch-private-key>' -e PAYFETCH_CDP_API_KEY_ID='<payfetch-cdp-api-key-id>' -e PAYFETCH_CDP_API_KEY_SECRET='<payfetch-cdp-api-key-secret>' -e PAYFETCH_CDP_WALLET_SECRET='<payfetch-cdp-wallet-secret>' -- npx -y @forum-labs/payfetch

{
  "mcpServers": {
    "payfetch": {
      "command": "npx",
      "args": [
        "-y",
        "@forum-labs/payfetch"
      ],
      "env": {
        "PAYFETCH_PRIVATE_KEY": "<payfetch-private-key>",
        "PAYFETCH_CDP_API_KEY_ID": "<payfetch-cdp-api-key-id>",
        "PAYFETCH_CDP_API_KEY_SECRET": "<payfetch-cdp-api-key-secret>",
        "PAYFETCH_CDP_WALLET_SECRET": "<payfetch-cdp-wallet-secret>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "payfetch": {
      "command": "npx",
      "args": [
        "-y",
        "@forum-labs/payfetch"
      ],
      "env": {
        "PAYFETCH_PRIVATE_KEY": "<payfetch-private-key>",
        "PAYFETCH_CDP_API_KEY_ID": "<payfetch-cdp-api-key-id>",
        "PAYFETCH_CDP_API_KEY_SECRET": "<payfetch-cdp-api-key-secret>",
        "PAYFETCH_CDP_WALLET_SECRET": "<payfetch-cdp-wallet-secret>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "payfetch": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@forum-labs/payfetch"
      ],
      "env": {
        "PAYFETCH_PRIVATE_KEY": "<payfetch-private-key>",
        "PAYFETCH_CDP_API_KEY_ID": "<payfetch-cdp-api-key-id>",
        "PAYFETCH_CDP_API_KEY_SECRET": "<payfetch-cdp-api-key-secret>",
        "PAYFETCH_CDP_WALLET_SECRET": "<payfetch-cdp-wallet-secret>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "payfetch": {
      "command": "npx",
      "args": [
        "-y",
        "@forum-labs/payfetch"
      ],
      "env": {
        "PAYFETCH_PRIVATE_KEY": "<payfetch-private-key>",
        "PAYFETCH_CDP_API_KEY_ID": "<payfetch-cdp-api-key-id>",
        "PAYFETCH_CDP_API_KEY_SECRET": "<payfetch-cdp-api-key-secret>",
        "PAYFETCH_CDP_WALLET_SECRET": "<payfetch-cdp-wallet-secret>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
PAYFETCH_PRIVATE_KEY	—	yes	0x-hex EVM private key for a DEDICATED low-balance wallet. Set exactly ONE signer source.
PAYFETCH_KEY_FILE	—	—	Path to a chmod-600 file holding a 0x-hex key (signer alt).
PAYFETCH_CDP_API_KEY_ID	—	yes	Coinbase CDP server-wallet key id (YOUR account).
PAYFETCH_CDP_API_KEY_SECRET	—	yes	Coinbase CDP API key secret.
PAYFETCH_CDP_WALLET_SECRET	—	yes	Coinbase CDP wallet secret.
PAYFETCH_CDP_ACCOUNT_NAME	—	—	Optional named CDP EVM account.
PAYFETCH_DATA_DIR	—	—	Ledger/state/config root. Default ~/.payfetch.
PAYFETCH_TEST_MODE	—	—	Any value -> receipts test:true, Base mainnet refused (Sepolia only).
PAYFETCH_APPROVER	—	—	Set to 1 to grant approval authority (never with a queue-capable mode).
PAYFETCH_VIA	—	—	Optional via= attribution slug sent on guard calls only.

Freshness

Maintained — last maintenance signal 3mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-07-10 · 3mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-07-06 · 3mo ago · official registry · v1.0.0

FAQ

›How do I install the Payfetch MCP server in Claude Code?

Run: claude mcp add payfetch -e PAYFETCH_PRIVATE_KEY='<payfetch-private-key>' -e PAYFETCH_CDP_API_KEY_ID='<payfetch-cdp-api-key-id>' -e PAYFETCH_CDP_API_KEY_SECRET='<payfetch-cdp-api-key-secret>' -e PAYFETCH_CDP_WALLET_SECRET='<payfetch-cdp-wallet-secret>' -- npx -y @forum-labs/payfetch. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Payfetch require an API key?

Yes. It expects PAYFETCH_PRIVATE_KEY, PAYFETCH_CDP_API_KEY_ID, PAYFETCH_CDP_API_KEY_SECRET, PAYFETCH_CDP_WALLET_SECRET, of which 4 are secrets.

›Can I use Payfetch as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Payfetch in the official MCP registry?

Yes, as io.github.forum-labs/payfetch.