io.github.forum-labs/payfetch MCP Server

Name: io.github.forum-labs/payfetch MCP Server
Author: io.github.forum-labs

io.github.forum-labs/payfetch

Repository Registry

What is the io.github.forum-labs/payfetch MCP server?

x402 paying-fetch client for AI agents. Spending caps, approval, receipts. Non-custodial.

How to install io.github.forum-labs/payfetch

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

PAYFETCH_PRIVATE_KEY
secret
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
secret
Coinbase CDP server-wallet key id (YOUR account).
PAYFETCH_CDP_API_KEY_SECRET
secret
Coinbase CDP API key secret.
PAYFETCH_CDP_WALLET_SECRET
secret
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.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "payfetch": {
      "command": "npx",
      "args": [
        "-y",
        "@forum-labs/payfetch"
      ],
      "env": {
        "PAYFETCH_PRIVATE_KEY": "<YOUR_PAYFETCH_PRIVATE_KEY>",
        "PAYFETCH_KEY_FILE": "<YOUR_PAYFETCH_KEY_FILE>",
        "PAYFETCH_CDP_API_KEY_ID": "<YOUR_PAYFETCH_CDP_API_KEY_ID>",
        "PAYFETCH_CDP_API_KEY_SECRET": "<YOUR_PAYFETCH_CDP_API_KEY_SECRET>",
        "PAYFETCH_CDP_WALLET_SECRET": "<YOUR_PAYFETCH_CDP_WALLET_SECRET>",
        "PAYFETCH_CDP_ACCOUNT_NAME": "<YOUR_PAYFETCH_CDP_ACCOUNT_NAME>",
        "PAYFETCH_DATA_DIR": "<YOUR_PAYFETCH_DATA_DIR>",
        "PAYFETCH_TEST_MODE": "<YOUR_PAYFETCH_TEST_MODE>",
        "PAYFETCH_APPROVER": "<YOUR_PAYFETCH_APPROVER>",
        "PAYFETCH_VIA": "<YOUR_PAYFETCH_VIA>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "payfetch": {
      "command": "npx",
      "args": [
        "-y",
        "@forum-labs/payfetch"
      ],
      "env": {
        "PAYFETCH_PRIVATE_KEY": "<YOUR_PAYFETCH_PRIVATE_KEY>",
        "PAYFETCH_KEY_FILE": "<YOUR_PAYFETCH_KEY_FILE>",
        "PAYFETCH_CDP_API_KEY_ID": "<YOUR_PAYFETCH_CDP_API_KEY_ID>",
        "PAYFETCH_CDP_API_KEY_SECRET": "<YOUR_PAYFETCH_CDP_API_KEY_SECRET>",
        "PAYFETCH_CDP_WALLET_SECRET": "<YOUR_PAYFETCH_CDP_WALLET_SECRET>",
        "PAYFETCH_CDP_ACCOUNT_NAME": "<YOUR_PAYFETCH_CDP_ACCOUNT_NAME>",
        "PAYFETCH_DATA_DIR": "<YOUR_PAYFETCH_DATA_DIR>",
        "PAYFETCH_TEST_MODE": "<YOUR_PAYFETCH_TEST_MODE>",
        "PAYFETCH_APPROVER": "<YOUR_PAYFETCH_APPROVER>",
        "PAYFETCH_VIA": "<YOUR_PAYFETCH_VIA>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "payfetch": {
      "command": "npx",
      "args": [
        "-y",
        "@forum-labs/payfetch"
      ],
      "env": {
        "PAYFETCH_PRIVATE_KEY": "<YOUR_PAYFETCH_PRIVATE_KEY>",
        "PAYFETCH_KEY_FILE": "<YOUR_PAYFETCH_KEY_FILE>",
        "PAYFETCH_CDP_API_KEY_ID": "<YOUR_PAYFETCH_CDP_API_KEY_ID>",
        "PAYFETCH_CDP_API_KEY_SECRET": "<YOUR_PAYFETCH_CDP_API_KEY_SECRET>",
        "PAYFETCH_CDP_WALLET_SECRET": "<YOUR_PAYFETCH_CDP_WALLET_SECRET>",
        "PAYFETCH_CDP_ACCOUNT_NAME": "<YOUR_PAYFETCH_CDP_ACCOUNT_NAME>",
        "PAYFETCH_DATA_DIR": "<YOUR_PAYFETCH_DATA_DIR>",
        "PAYFETCH_TEST_MODE": "<YOUR_PAYFETCH_TEST_MODE>",
        "PAYFETCH_APPROVER": "<YOUR_PAYFETCH_APPROVER>",
        "PAYFETCH_VIA": "<YOUR_PAYFETCH_VIA>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "payfetch": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@forum-labs/payfetch"
      ],
      "env": {
        "PAYFETCH_PRIVATE_KEY": "<YOUR_PAYFETCH_PRIVATE_KEY>",
        "PAYFETCH_KEY_FILE": "<YOUR_PAYFETCH_KEY_FILE>",
        "PAYFETCH_CDP_API_KEY_ID": "<YOUR_PAYFETCH_CDP_API_KEY_ID>",
        "PAYFETCH_CDP_API_KEY_SECRET": "<YOUR_PAYFETCH_CDP_API_KEY_SECRET>",
        "PAYFETCH_CDP_WALLET_SECRET": "<YOUR_PAYFETCH_CDP_WALLET_SECRET>",
        "PAYFETCH_CDP_ACCOUNT_NAME": "<YOUR_PAYFETCH_CDP_ACCOUNT_NAME>",
        "PAYFETCH_DATA_DIR": "<YOUR_PAYFETCH_DATA_DIR>",
        "PAYFETCH_TEST_MODE": "<YOUR_PAYFETCH_TEST_MODE>",
        "PAYFETCH_APPROVER": "<YOUR_PAYFETCH_APPROVER>",
        "PAYFETCH_VIA": "<YOUR_PAYFETCH_VIA>"
      }
    }
  }
}

Claude Code

claude mcp add payfetch --env PAYFETCH_PRIVATE_KEY=<YOUR_PAYFETCH_PRIVATE_KEY> --env PAYFETCH_KEY_FILE=<YOUR_PAYFETCH_KEY_FILE> --env PAYFETCH_CDP_API_KEY_ID=<YOUR_PAYFETCH_CDP_API_KEY_ID> --env PAYFETCH_CDP_API_KEY_SECRET=<YOUR_PAYFETCH_CDP_API_KEY_SECRET> --env PAYFETCH_CDP_WALLET_SECRET=<YOUR_PAYFETCH_CDP_WALLET_SECRET> --env PAYFETCH_CDP_ACCOUNT_NAME=<YOUR_PAYFETCH_CDP_ACCOUNT_NAME> --env PAYFETCH_DATA_DIR=<YOUR_PAYFETCH_DATA_DIR> --env PAYFETCH_TEST_MODE=<YOUR_PAYFETCH_TEST_MODE> --env PAYFETCH_APPROVER=<YOUR_PAYFETCH_APPROVER> --env PAYFETCH_VIA=<YOUR_PAYFETCH_VIA> -- npx -y @forum-labs/payfetch