Payfetch
x402 paying-fetch client for AI agents. Spending caps, approval, receipts. Non-custodial.
- Pricing
- Open source
- Runs
- Locally
- Version
- 1.0.0
- Listing updated
- 5 days ago
About Payfetch
Payfetch is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add payfetch --env PAYFETCH_PRIVATE_KEY='<PAYFETCH_PRIVATE_KEY>' --env PAYFETCH_CDP_API_KEY_ID='<PAYFETCH_CDP_API_KEY_ID>' --env PAYFETCH_CDP_API_KEY_SECRET='<PAYFETCH_CDP_API_KEY_SECRET>' --env PAYFETCH_CDP_WALLET_SECRET='<PAYFETCH_CDP_WALLET_SECRET>' -- npx -y @forum-labs/payfetchAdd to claude_desktop_config.json
{
"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
{
"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 .vscode/mcp.json
{
"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 ~/.codeium/windsurf/mcp_config.json
{
"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 your client's MCP settings (most use this shape)
{
"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>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PAYFETCH_PRIVATE_KEY0x-hex EVM private key for a DEDICATED low-balance wallet. Set exactly ONE signer source.PAYFETCH_KEY_FILEPath to a chmod-600 file holding a 0x-hex key (signer alt).PAYFETCH_CDP_API_KEY_IDCoinbase CDP server-wallet key id (YOUR account).PAYFETCH_CDP_API_KEY_SECRETCoinbase CDP API key secret.PAYFETCH_CDP_WALLET_SECRETCoinbase CDP wallet secret.PAYFETCH_CDP_ACCOUNT_NAMEOptional named CDP EVM account.PAYFETCH_DATA_DIRLedger/state/config root. Default ~/.payfetch.PAYFETCH_TEST_MODEAny value -> receipts test:true, Base mainnet refused (Sepolia only).PAYFETCH_APPROVERSet to 1 to grant approval authority (never with a queue-capable mode).PAYFETCH_VIAOptional via= attribution slug sent on guard calls only.
Pricing
Open source
Payfetch FAQ
Is Payfetch free?
Yes. Payfetch is open source, so you can use and self-host it for free.
How do I add Payfetch to Claude Code?
Run this command in your terminal: claude mcp add payfetch --env PAYFETCH_PRIVATE_KEY='<PAYFETCH_PRIVATE_KEY>' --env PAYFETCH_CDP_API_KEY_ID='<PAYFETCH_CDP_API_KEY_ID>' --env PAYFETCH_CDP_API_KEY_SECRET='<PAYFETCH_CDP_API_KEY_SECRET>' --env PAYFETCH_CDP_WALLET_SECRET='<PAYFETCH_CDP_WALLET_SECRET>' -- npx -y @forum-labs/payfetch
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.