Beggar Bot

A local MCP server exposing Beggar Bot's pay-per-call x402 utilities on Base: USDC payment verification, risk scores and signed receipts.

What you can do

Verify USDC payments through the verify_payment tool, which checks a payment against the service's verification route for a fee per call. Retrieve risk scores for an address or payment via risk_score. Create signed receipts with signed_receipt and check them for free with verify_receipt. When a paid tool is called without payment proof, the server returns the x402 payment requirements instead of a result.

When to use it

Useful when an assistant needs to check USDC payments on Base, obtain a risk score, or issue and verify signed receipts, and the user is willing to pay a small per-call fee in USDC through x402.

Requirements

Runs locally over stdio; the README lists Node.js 18 or later and an npx or local checkout launch. Network access to the Beggar Bot service is needed, and BEGGAR_BOT_URL can point at a different deployment. Paid calls need an X-PAYMENT header built with the user's own x402 client and passed as x_payment.