Obol — Metered Api Marketplace

by superbigroach

302 downloads
Not rated
GitHub

About

Pay-per-call API marketplace for AI agents. Discover and pay for metered services in USDC on Arc — no subscription, no account. Agents pay per call, sellers earn instantly.

Details

Author
superbigroach
Downloads
302
Categories
Developer Tools

- Search available APIs by keyword using find_service.
- Pay in USDC and call any listed API instantly.
- Publish your own API for other agents to buy.
- Check your Arc wallet balance with get_balance.
- No subscriptions or accounts, pay per call.
- Sellers get paid instantly on-chain.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Obol — Metered Api Marketplace
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Obtain testnet USDC from faucet.circle.com, then integrate the Obol server into your AI agent platform (e.g., Claude or Cursor) by adding the server configuration. The server exposes tools such as find_service, pay_and_call, list_service, and get_balance.

find_service

Search the Obol directory for metered APIs an agent can pay for per call. Results are relevance-ranked (name > category > description). Returns id, price (USDC), description, the callable URL, and a relevance score.

deposit

Fund the agent's Gateway balance once (gas-free spending afterward). Amount in USDC, e.g. '5'.

pay_and_call

Pay for and call an Obol metered service via Circle Gateway. Keyless by default: with OBOL_API_KEY set, Obol's relayer pays the seller on your behalf from your funded spending balance — no private key needed. Enforces your per-call maxPrice and your account's spending limits. Idempotent on retry. (Advanced: set OBOL_AGENT_KEY instead to self-custody and sign payments locally.)

list_service

List (publish) a new service on the Obol marketplace so other agents can discover and pay for it. Requires the seller's Obol API key (OBOL_API_KEY env). Obol auto-issues a real ACK-ID verifiable credential for the seller's wallet and returns the marketplace URL.

get_balance

Get the agent wallet + Gateway USDC balances on Arc testnet.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "obol \u2014 metered api marketplace": {
            "obol": {
                "command": "npx",
                "args": [
                    "-y",
                    "@superbigroach/obol-mcp"
                ],
                "env": {
                    "OBOL_AGENT_KEY": "<your-arc-wallet-private-key>"
                }
            }
        }
    }
}

McpServers

{
    "obol": {
        "command": "npx",
        "args": [
            "-y",
            "@superbigroach/obol-mcp"
        ],
        "env": {
            "OBOL_AGENT_KEY": "<your-arc-wallet-private-key>"
        }
    }
}

Obol — Metered API Marketplace

Let any AI agent find, pay for, and call metered APIs in USDC on Arc testnet.

Tools

- find_service — search available APIs by keyword - pay_and_call — pay in USDC and call any listed service instantly - list_service — publish your own API for other agents to buy - get_balance — check your Arc wallet balance

Why Obol

No subscriptions. No accounts. Agents pay fractions of a cent per call, settled on-chain. Sellers get paid instantly.

Quickstart

Get testnet USDC at faucet.circle.com, then add to Claude/Cursor config with your Arc wallet key.
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.