How do I install Beggar Bot?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Beggar Bot need an API key?

No required environment variable is listed on this record.

What transport does Beggar Bot use?

Beggar Bot runs locally over stdio.

Beggar Bot MCP server

Q: When was Beggar Bot last checked?

Last checked 2026-11-09. x402 utilities on Base: USDC payment verification, risk scores, signed receipts ($0.01 USDC/call).

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

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

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

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

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.beggar-bot-x402-beggar-bot-mcp": {4      "command": "mcpb",5      "args": [6        "https://github.com/beggar-bot-x402/beggar-bot-mcp/releases/download/v0.1.0/beggar-bot-mcp-0.1.0.mcpb"7      ]8    }9  }10}

claude_desktop_config.json

Local · mcpbPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

beggar-bot-mcp

MCP server for Beggar Bot, a set of pay-per-call x402 utilities on Base: USDC payment verification, risk scores, and signed receipts. Each paid call costs $0.01 USDC on Base through the x402 protocol.

The server holds no keys and never pays anything itself. If you call a paid tool without x_payment, it returns the HTTP 402 x402 payment requirements. To pay, build an X-PAYMENT header with your own x402 client (for example x402-fetch) and pass it as x_payment.

Tools

Tool	Route	Price
`verify_payment`	`GET /v1/verify`	$0.01 USDC (Base, x402)
`risk_score`	`GET /v1/risk`	$0.01 USDC (Base, x402)
`signed_receipt`	`POST /v1/receipt`	$0.01 USDC (Base, x402)
`verify_receipt`	`POST /v1/receipt/verify`	free

Live service: https://beggar-bot-demand.beggarbot.workers.dev

MCP client config (Claude Desktop, Cursor, or any stdio MCP client)

{
  "mcpServers": {
    "beggar-bot": {
      "command": "npx",
      "args": ["-y", "github:beggar-bot-x402/beggar-bot-mcp"]
    }
  }
}

Requires Node.js 18 or later. Set BEGGAR_BOT_URL to point at a different deployment.

From a local checkout: npm install, then "command": "node", "args": ["/path/to/beggar-bot-mcp/index.js"].

Discovery

x402scan: https://www.x402scan.com/server/161aa10d-fa13-46d1-80aa-e2d1c32be6dd
x402 manifest: https://beggar-bot-demand.beggarbot.workers.dev/.well-known/x402
OpenAPI: https://beggar-bot-demand.beggarbot.workers.dev/openapi.json
llms.txt: https://beggar-bot-demand.beggarbot.workers.dev/llms.txt
Agent card: https://beggar-bot-demand.beggarbot.workers.dev/.well-known/agent.json
Contact: [email protected]

License

MIT

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Beggar Bot?

Does Beggar Bot need an API key?

What transport does Beggar Bot use?

When was Beggar Bot last checked?

Documentation

beggar-bot-mcp

Tools

MCP client config (Claude Desktop, Cursor, or any stdio MCP client)

Discovery

License