Skip to content
MCP server

402-LAB

Budget-capped x402 buyer that lets an agent find and pay for API calls in USDC

Runs locallyStatus and history
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.mcpb

Add 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)Required
  • NETWORKeip155:84532 (Base Sepolia, default) or eip155:8453 (Base mainnet)
  • MANDATE_MAX_USDCAbsolute cap any mandate may reach
  • CATALOG_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

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government