Give Your AI Agent a Wallet

Let your AI agent discover, evaluate, and pay for APIs autonomously. The Obolos MCP server and CLI give any LLM-powered agent access to hundreds of pay-per-call APIs with automatic USDC micropayments on Base.

MCP Server

The Obolos MCP server exposes the entire marketplace as tools your AI agent can call natively. Search APIs, check pricing, execute calls with automatic payment, and check your balance — all through natural language.

Available Tools

See Jobs & Negotiation Protocol for full documentation.

Setup: Claude Code

Register globally (all projects) or per-project:

# Global (all projects)
claude mcp add obolos --scope user \
  -e OBOLOS_PRIVATE_KEY=0xyour_private_key \
  -- npx -y @obolos_tech/mcp-server

# Per-project (current project only)
claude mcp add obolos \
  -e OBOLOS_PRIVATE_KEY=0xyour_private_key \
  -- npx -y @obolos_tech/mcp-server

# Browse-only (no payments)
claude mcp add obolos -- npx -y @obolos_tech/mcp-server

Setup: Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "obolos": {
      "command": "npx",
      "args": ["-y", "@obolos_tech/mcp-server"],
      "env": {
        "OBOLOS_PRIVATE_KEY": "0xyour_private_key"
      }
    }
  }
}

Setup: Cursor / Windsurf / Other MCP Clients

Add to your MCP config:

{
  "obolos": {
    "command": "npx",
    "args": ["-y", "@obolos_tech/mcp-server"],
    "env": {
      "OBOLOS_PRIVATE_KEY": "0xyour_private_key"
    }
  }
}

Example: Natural Language → Tool Calls

Once configured, your agent understands requests like:

"Search for token price APIs on Obolos"
  → search_apis(query: "token price")

"How much does the DeFi portfolio API cost?"
  → get_api_details(api_id: "ext-abc123")

"Get the current ETH price using Obolos"
  → call_api(api_id: "ext-abc123", method: "GET", query_params: {"symbol": "ETH"})

"What's my Obolos wallet balance?"
  → get_balance()

CLI

The Obolos CLI lets you search, browse, and call x402 APIs directly from the terminal. No setup required — just run with npx.

npx @obolos_tech/cli search "token price"
npx @obolos_tech/cli info ext-abc123
npx @obolos_tech/cli call ext-abc123 --body '{"symbol":"ETH"}'

Commands

Example Session

$ npx @obolos_tech/cli search "weather"
Found 3 APIs:

  ext-a1b2c3d4  Weather Forecast    $0.005/call
  ext-e5f6g7h8  Climate Data API    $0.01/call
  ext-i9j0k1l2  UV Index Lookup     $0.002/call

$ npx @obolos_tech/cli info ext-a1b2c3d4
Weather Forecast
  Price: $0.005 per call
  Method: GET
  Input: ?city=string

$ npx @obolos_tech/cli call ext-a1b2c3d4 --query city=Prague
{
  "city": "Prague",
  "forecast": "Partly cloudy, 18°C",
  "humidity": "62%"
}

How Payments Work

1. Agent calls an API — via MCP tool or CLI command
2. Proxy returns HTTP 402 — with payment requirements (price, recipient, network)
3. Client signs payment — EIP-712 USDC authorization using your private key
4. Request retries with payment — API response is returned to the agent

Payments are USDC micropayments on Base ($0.001–$0.10 per call). Only 1% platform fee — 99% goes directly to the API creator.

Environment Variables

Skill Files

Skill files are machine-readable markdown documents that teach AI agents how to use Obolos. Point your agent at these URLs to give it full context:

Get Started