Skip to content
MCP server

buy

Pay-per-request CLI and MCP tools for agents to buy APIs and VMs with stablecoins on Celo

Runs locallyStatus and history
Pricing
Paid
Platforms
CLI, API, macOS
Runs
Locally
Version
0.8.5
Listing updated
2 days ago

About buy

buy is a paid MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

The agent gets a wallet in the OS keychain and pays for services one request at a time. buy curl behaves like curl: it reads a service's HTTP 402 challenge, signs a stablecoin transfer locally and retries with payment attached. A --max-amount cap refuses the call before signing if the quote is higher.

Payment can be in USDC, USD₮ or USA₮ on Celo mainnet, and the gateway sponsors gas so the wallet needs no CELO. A --sandbox mode runs on Celo Sepolia with test USDC from a faucet, capped at 2 USD of upstream cost per day overall. Some services ask for a zero-knowledge proof from the Self app showing age 18 or over and no sanctions listing.

The docs also show renting one-hour Google Cloud VMs in us-west1, from $0.0168 an hour for e2-micro to $0.5361 for e2-standard-8, where the larger sizes need the Self proof. The server runs over stdio and reads the wallet locally. The docs mark the release v0.8.5 as beta.

Install

Run in a terminal

claude mcp add buy -- npx -y @celo/buy

Add to claude_desktop_config.json

{
  "mcpServers": {
    "buy": {
      "command": "npx",
      "args": [
        "-y",
        "@celo/buy"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "buy": {
      "command": "npx",
      "args": [
        "-y",
        "@celo/buy"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "buy": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@celo/buy"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "buy": {
      "command": "npx",
      "args": [
        "-y",
        "@celo/buy"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "buy": {
      "command": "npx",
      "args": [
        "-y",
        "@celo/buy"
      ]
    }
  }
}

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

buy_discover
Lists, searches and shows skills in the service catalogue.
buy_pay_quote
Quotes a request and stops at the 402 without paying.
buy_curl
Sends a request and pays the 402 challenge.
buy_fetch
Alias of buy_curl.
buy_balance
Shows wallet balance and account.
buy_whoami
Shows the active account.
buy_verify_status
Shows Self verification status.
buy_send
Sends tokens directly; opt-in behind a budget or allowlist.

What it does

Pay per request
buy curl signs a stablecoin payment on a 402 response and retries.
Spending cap
--max-amount refuses a request before signing if the quote exceeds it.
Sandbox mode
Runs on Celo Sepolia with free test USDC.
Quote without paying
buy quote prints each offer's token, price, network and recipient.
Self verification
Zero-knowledge age and sanctions proof for services that require it.
Rentable VMs
One-hour Google Cloud VMs paid per request, with a poll URL for results.
Keychain wallet
The key is generated and kept in the OS keychain.

Good for

  • Let an agent buy a one-off API call without an account
  • Run a short script on a rented VM and collect its output
  • Price a request with a quote before spending
  • Test payment flows with free test USDC
  • Cap an agent's spending per call

Pricing

Paid

Pay per request in stablecoins; VMs from $0.0168/hour; free sandbox

Prices change. Check usebuy.ai before you buy.

buy FAQ

Which tokens can I pay with?

USDC by default, or USD₮ and USA₮ on Celo mainnet.

Do I need CELO for gas?

No. The gateway sponsors gas for requests.

Can I try it without real money?

Yes, --sandbox uses Celo Sepolia test USDC from a faucet.

What does the MCP server register?

Seven tools by default; buy_send is an eighth, opt-in behind a budget or allowlist.

What Node version is needed?

Node.js 22 or newer.

Is buy free?

No. buy is a paid product.

How do I add buy to Claude Code?

Run this command in your terminal: claude mcp add buy -- npx -y @celo/buy

What are the best alternatives to buy?

The closest alternatives to buy are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Alternatives to buy

  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