402-LAB
Budget-capped x402 buyer that lets an agent find and pay for API calls in USDC
- Pricing
- Open source
- Platforms
- macOS, Windows, Linux
- Runs
- Locally
- Version
- 0.1.0
- Listing updated
- today
About 402-LAB
402-LAB is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
402-LAB is the buyer half of an open-source experiment in agent commerce built around the x402 payment protocol. You give your assistant a spending allowance in plain words, such as staying within one dollar. The agent then looks for a paid API in the x402 Bazaar or in seller catalogue files, reads the price quoted in the HTTP 402 response, and pays in USDC only if the amount fits.
The server itself enforces the ceiling, the per-call limit, the network and the seller allow-list, so the agent cannot widen its own authority. It runs locally over stdio and needs a wallet private key, which the registry entry says should hold only small amounts. It defaults to Base Sepolia, with Base mainnet as an option.
The project's own demo seller offers a Korean business-registration status lookup at 0.02 USDC per call. The README says settlements so far are two from internal wallets and promises no buyer traffic or revenue.
Install
Run in a terminal
claude mcp add 402-lab --env BUYER_PRIVATE_KEY='<BUYER_PRIVATE_KEY>' -- npx -y https://github.com/Kairose-master/handsel-mandate/releases/download/mcp-v0.1.0/402-lab.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"402-lab": {
"command": "npx",
"args": [
"-y",
"https://github.com/Kairose-master/handsel-mandate/releases/download/mcp-v0.1.0/402-lab.mcpb"
],
"env": {
"BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"402-lab": {
"command": "npx",
"args": [
"-y",
"https://github.com/Kairose-master/handsel-mandate/releases/download/mcp-v0.1.0/402-lab.mcpb"
],
"env": {
"BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"402-lab": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/Kairose-master/handsel-mandate/releases/download/mcp-v0.1.0/402-lab.mcpb"
],
"env": {
"BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"402-lab": {
"command": "npx",
"args": [
"-y",
"https://github.com/Kairose-master/handsel-mandate/releases/download/mcp-v0.1.0/402-lab.mcpb"
],
"env": {
"BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"402-lab": {
"command": "npx",
"args": [
"-y",
"https://github.com/Kairose-master/handsel-mandate/releases/download/mcp-v0.1.0/402-lab.mcpb"
],
"env": {
"BUYER_PRIVATE_KEY": "<BUYER_PRIVATE_KEY>"
}
}
}
}Configuration
BUYER_PRIVATE_KEY0x-prefixed private key of the paying wallet (keep only small amounts)RequiredNETWORKeip155:84532 (Base Sepolia, default) or eip155:8453 (Base mainnet)MANDATE_MAX_USDCAbsolute cap any mandate may reachCATALOG_URLSComma-separated seller product.json URLs searched besides the x402 Bazaar
What it does
- Plain-language budget
- Takes a spending allowance stated in words and turns it into enforced limits.
- Bazaar discovery
- Searches the x402 Bazaar and configured seller product.json files for matching APIs.
- Pre-payment checks
- Checks per-call limit, remaining budget and seller policy before signing.
- Server-enforced caps
- Applies the maximum, per-call limit, network and seller allow-list on the server side.
- Free price check
- Quotes the price from the 402 response before any wallet signature.
- Seller tooling
- The repository also includes a seller payment gate and a local Seller Studio draft.
Good for
- Let an agent buy a paid API call within a fixed budget
- Test x402 payments on Base Sepolia without real funds
- Try a pay-per-call Korean business registration lookup
- Prototype pay-per-call selling for a vibe-coded API
Pricing
Open source
Open source; paid APIs it calls are billed in USDC per call
Prices change. Check handsel-mandate-demo.vercel.app before you buy.
402-LAB FAQ
Which networks does it support?
Base Sepolia by default and Base mainnet when configured.
What does it need to run?
A wallet private key for the paying wallet, kept to small amounts, plus optional limit and catalogue settings.
Can the agent raise its own spending limit?
No. The README says the agent cannot create its own delegation or widen permissions.
How is it installed?
Via npx from the GitHub repository, or as an mcpb bundle for Claude Desktop.
Is 402-LAB free?
Yes. 402-LAB is open source, so you can use and self-host it for free.
How do I add 402-LAB to Claude Code?
Run this command in your terminal: claude mcp add 402-lab --env BUYER_PRIVATE_KEY='<BUYER_PRIVATE_KEY>' -- npx -y https://github.com/Kairose-master/handsel-mandate/releases/download/mcp-v0.1.0/402-lab.mcpb
What are the best alternatives to 402-LAB?
The closest alternatives to 402-LAB are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.
Alternatives to 402-LAB

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