Beggar Bot
Pay-per-call x402 utilities on Base: payment checks, risk scores and signed receipts
- 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.mcpbAdd 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"
]
}
}
}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"
]
}
}
}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

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government