# Beggar Bot

> Beggar Bot is an open-source MCP server for finance and payments. Pay-per-call x402 utilities on Base: payment checks, risk scores and signed receipts. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Website:** https://beggar-bot-demand.beggarbot.workers.dev
- **Repository:** https://github.com/beggar-bot-x402/beggar-bot-mcp
- **MCP Registry name:** io.github.beggar-bot-x402/beggar-bot-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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"
      ]
    }
  }
}
```

## Tools

- `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

## 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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/beggar-bot
