Skip to content
MCP server

Beggar Bot

Pay-per-call x402 utilities on Base: payment checks, risk scores and signed receipts

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About Beggar Bot

Beggar Bot is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Each paid call costs $0.01 USDC on Base through the x402 protocol. The MCP server itself holds no keys and never pays: calling a paid tool without an x_payment argument returns the HTTP 402 payment requirements, and the caller builds an X-PAYMENT header with its own x402 client such as x402-fetch.

Four tools are listed in the README. verify_payment, risk_score and signed_receipt are paid, while verify_receipt is free. The hosted service behind them also advertises a long list of paid /v1 routes covering exchange trades and order books, DeFi lending and swap data, bridges and on-chain status, but the README documents only the four tools.

It runs locally over stdio via npx (Node.js 18 or newer), and BEGGAR_BOT_URL can point it at another deployment. Discovery files include an x402 manifest, OpenAPI spec, llms.txt and an agent card.

Install

Run in a terminal

claude mcp add beggar-bot-mcp -- npx -y https://github.com/beggar-bot-x402/beggar-bot-mcp/releases/download/v0.1.0/beggar-bot-mcp-0.1.0.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "beggar-bot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/beggar-bot-x402/beggar-bot-mcp/releases/download/v0.1.0/beggar-bot-mcp-0.1.0.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "beggar-bot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/beggar-bot-x402/beggar-bot-mcp/releases/download/v0.1.0/beggar-bot-mcp-0.1.0.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "beggar-bot-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/beggar-bot-x402/beggar-bot-mcp/releases/download/v0.1.0/beggar-bot-mcp-0.1.0.mcpb"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "beggar-bot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/beggar-bot-x402/beggar-bot-mcp/releases/download/v0.1.0/beggar-bot-mcp-0.1.0.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "beggar-bot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/beggar-bot-x402/beggar-bot-mcp/releases/download/v0.1.0/beggar-bot-mcp-0.1.0.mcpb"
      ]
    }
  }
}

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

verify_payment
Verify a USDC payment through GET /v1/verify
risk_score
Get a risk score through GET /v1/risk
signed_receipt
Create a signed receipt through POST /v1/receipt
verify_receipt
Verify a signed receipt, free

What it does

USDC payment verification
verify_payment checks a payment for $0.01 per call.
Risk scores
risk_score returns a score through the paid /v1/risk route.
Signed receipts
signed_receipt issues a receipt, and verify_receipt checks one for free.
No keys held
The server returns 402 requirements and leaves payment to your own x402 client.
Configurable endpoint
Set BEGGAR_BOT_URL to use a different deployment.

Good for

  • Let an agent verify a USDC payment on Base
  • Issue and later validate signed receipts for pay-per-call services
  • Score the risk of a transaction before an agent acts
  • Experiment with x402 payment flows in an MCP client

Pricing

Open source

MIT code; paid calls $0.01 USDC each on Base

Prices change. Check beggar-bot-demand.beggarbot.workers.dev before you buy.

Beggar Bot FAQ

What does a call cost?

$0.01 USDC on Base per paid call. verify_receipt is free.

Does the server spend my money?

No. It holds no keys and never pays; you supply the X-PAYMENT header via x_payment.

How do I run it?

Add an npx entry for github:beggar-bot-x402/beggar-bot-mcp to a stdio MCP client; Node.js 18+ is required.

What licence is it?

MIT.

Is Beggar Bot free?

Yes. Beggar Bot is open source, so you can use and self-host it for free.

How do I add Beggar Bot to Claude Code?

Run this command in your terminal: claude mcp add beggar-bot-mcp -- npx -y https://github.com/beggar-bot-x402/beggar-bot-mcp/releases/download/v0.1.0/beggar-bot-mcp-0.1.0.mcpb

What are the best alternatives to Beggar Bot?

The closest alternatives to Beggar Bot are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Alternatives to Beggar Bot

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government