# buy

> buy is a paid MCP server for finance and payments. Pay-per-request CLI and MCP tools for agents to buy APIs and VMs with stablecoins on Celo. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API, macOS, Windows, Linux
- **Website:** https://usebuy.ai/docs
- **MCP Registry name:** ai.usebuy/buy
- **Categories:** finance and payments, cloud and infrastructure
- **Listing updated:** 2026-11-15

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

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

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

- [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/buy
