x402 paying-fetch client for AI agents. Spending caps, approval, receipts. Non-custodial.
registry version 1.0.0
npm
npx -y @forum-labs/payfetchnpm
npx -y @forum-labs/payfetch@1.0.0
Pick your client — the config below is generated for this server (local stdio). Copy respects the “Pin version” switch above.
claude_desktop_config.json
{
"mcpServers": {
"payfetch": {
"command": "npx",
"args": [
"-y",
"@forum-labs/payfetch"
],
"env": {
"PAYFETCH_PRIVATE_KEY": "<YOUR_PAYFETCH_PRIVATE_KEY>",
"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>"
}
}
}
}{
"mcpServers": {
"payfetch": {
"command": "npx",
"args": [
"-y",
"@forum-labs/payfetch@1.0.0"
],
"env": {
"PAYFETCH_PRIVATE_KEY": "<YOUR_PAYFETCH_PRIVATE_KEY>",
"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>"
}
}
}
}Format verified against the official Claude Desktop docs ↗.
terminal
claude mcp add --env PAYFETCH_PRIVATE_KEY=<YOUR_PAYFETCH_PRIVATE_KEY> --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> payfetch -- npx -y @forum-labs/payfetch
claude mcp add --env PAYFETCH_PRIVATE_KEY=<YOUR_PAYFETCH_PRIVATE_KEY> --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> payfetch -- npx -y @forum-labs/payfetch@1.0.0
Format verified against the official Claude Code docs ↗.
.cursor/mcp.json
{
"mcpServers": {
"payfetch": {
"command": "npx",
"args": [
"-y",
"@forum-labs/payfetch"
],
"env": {
"PAYFETCH_PRIVATE_KEY": "<YOUR_PAYFETCH_PRIVATE_KEY>",
"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>"
}
}
}
}{
"mcpServers": {
"payfetch": {
"command": "npx",
"args": [
"-y",
"@forum-labs/payfetch@1.0.0"
],
"env": {
"PAYFETCH_PRIVATE_KEY": "<YOUR_PAYFETCH_PRIVATE_KEY>",
"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>"
}
}
}
}Format verified against the official Cursor docs ↗.
.vscode/mcp.json
{
"servers": {
"payfetch": {
"command": "npx",
"args": [
"-y",
"@forum-labs/payfetch"
],
"env": {
"PAYFETCH_PRIVATE_KEY": "<YOUR_PAYFETCH_PRIVATE_KEY>",
"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>"
}
}
}
}{
"servers": {
"payfetch": {
"command": "npx",
"args": [
"-y",
"@forum-labs/payfetch@1.0.0"
],
"env": {
"PAYFETCH_PRIVATE_KEY": "<YOUR_PAYFETCH_PRIVATE_KEY>",
"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>"
}
}
}
}Format verified against the official VS Code docs ↗.
mcp_config.json
{
"mcpServers": {
"payfetch": {
"command": "npx",
"args": [
"-y",
"@forum-labs/payfetch"
],
"env": {
"PAYFETCH_PRIVATE_KEY": "<YOUR_PAYFETCH_PRIVATE_KEY>",
"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>"
}
}
}
}{
"mcpServers": {
"payfetch": {
"command": "npx",
"args": [
"-y",
"@forum-labs/payfetch@1.0.0"
],
"env": {
"PAYFETCH_PRIVATE_KEY": "<YOUR_PAYFETCH_PRIVATE_KEY>",
"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>"
}
}
}
}Format verified against the official Windsurf docs ↗.
Defined in the server's official registry manifest. Required secrets are shown as <YOUR_…> placeholders in the configs above.
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).最近更新于 124 天前 · MIT license
payfetch payfetch lets an AI agent fetch a URL and, when the server answers HTTP 402 (the x402 payment protocol), pay for it automatically, but only within a spending policy you control. It is non custodial: you bring your own wallet, the key stays on your machine, and no MCP tool can raise the limi…
Summary from the project README — github.com/forum-labs/payfetch
Distributed as npm, listed under Web APIs. Review our MCP security guide before granting access to real data.
payfetch payfetch lets an AI agent fetch a URL and, when the server answers HTTP 402 (the x402 payment protocol), pay for it automatically, but only within a spending policy you control. It is non custodial: you bring your own wallet, the key stays on your machine, and no MCP tool can raise the limi
Run the install command shown above, then paste the config for your client (Claude Desktop, Claude Code, Cursor, VS Code or Windsurf) into its MCP settings and restart the client.
The MCP server itself is free to install. The source is public on https://github.com/forum-labs/payfetch. Any third-party service it calls may require its own API key and account.
Any MCP-compatible client can use it, including Claude Desktop, Claude Code, Cursor, VS Code, Windsurf and custom agents.
Publish this server? Link back with a badge on your README or site — copy either snippet.
Markdown
[](https://mcpnav.net/server/payfetch/)
HTML
<a href="https://mcpnav.net/server/payfetch/"><img src="https://mcpnav.net/badge/payfetch.svg" alt="Listed on MCPNav" height="20"></a>