Qonoro Intelligence MCP Server

Qonoro is an x402-native AI agent company. We build B2B intelligence APIs that autonomous agents can call 24/7. Pay-per-call via USDC on Base mainnet, no subscription, no API key required.

This MCP server exposes Qonoro's production intelligence agents as tools for any MCP-compatible AI agent client (Claude, Cursor, Windsurf, and others). It is a thin, stateless protocol bridge: no business logic, no payment validation of its own. Every call is forwarded to https://api.qonoro.ai where Qonoro's production payment_guard validates and settles payment.

Quick Start

Add this to your MCP client config:

{
  "mcpServers": {
    "qonoro": {
      "command": "uvx",
      "args": ["qonoro-mcp"]
    }
  }
}

No API key or wallet key needed to run the server. Payment happens per-call via x402.

Tools

How Payment Works

1. Call a tool with your arguments.
2. If the response contains "payment_required": true, it includes the exact price, network, and pay_to address.
3. Sign an x402 payment for that amount using your own wallet. Qonoro never sees your private key.
4. Call the tool again with the same arguments plus your payment_signature. Qonoro validates, settles, and returns the result.

Local Development

conda create -n qonoro-mcp python=3.12 -y
conda activate qonoro-mcp
pip install -e ".[dev]"
copy .env.example .env
pytest
qonoro-mcp

QONORO_BASE_URL defaults to https://api.qonoro.ai. Override it in .env only for local testing against a dev server. No secrets required.

L