qonoro-mcp 0.5.0

MCP server exposing Qonoro's x402 intelligence agents as tools for any MCP-compatible AI agent client.

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

MCP (Model Context Protocol) server that exposes Qonoro's production x402 intelligence agents as tools, so any MCP-compatible AI agent client can discover and call them directly -- no custom HTTP/x402 client code needed.

This server is a thin, stateless protocol bridge. It contains no business logic and no payment validation of its own: every call is forwarded to the real https://api.qonoro.ai endpoint, and Qonoro's existing production payment_guard validates and settles payment exactly as it does for any direct HTTP/Bazaar caller today.

Tools exposed

Tool	Qonoro endpoint	Price	Description
qonoro_company_enrich	POST /v1/company/enrich	$0.25 USDC	Basic company identity: legal name, industry, size, HQ, status, confidence score
qonoro_company_research	POST /v1/company/research	$2.00 USDC	Premium research bundle: orchestrates competitor analysis, sales signals, decision makers, and verified claims in one call
qonoro_competitors_analyze	POST /v1/competitors/analyze	$0.50 USDC	Structured competitor analysis: direct, indirect, and alternative competitors with sources
qonoro_sales_signals_find	POST /v1/sales-signals/find	$0.75 USDC	Evidence-backed buying signals: funding, hiring, product launches, partnerships
qonoro_intent_signals_find	POST /v1/intent-signals/find	$0.75 USDC	Active buying intent: RFPs, vendor evaluations, tech stack changes, competitor switches
qonoro_job_change_detect	POST /v1/job-changes/detect	$0.50 USDC	Detect when a decision maker leaves or joins a company — most actionable B2B sales trigger
qonoro_person_enrich	POST /v1/person/enrich	$1.25 USDC	Person enrichment: title, seniority, department, decision-maker flag, LinkedIn, bio
qonoro_revenue_qualify	POST /v1/revenue/qualify-lead	$0.75 USDC	Lead qualification: score, breakdown, decision-maker targets, recommended next action
qonoro_domain_intelligence	POST /v1/domain/intelligence	$0.25 USDC	Domain intel: tech stack, DNS, WHOIS, email provider, hosting, domain age
qonoro_news_sentiment	POST /v1/news/sentiment	$0.50 USDC	Real-time news sentiment: score, signal strength, key themes, per-article sentiment, recommended action

Installation

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

How payment works

1. Call the tool with your normal arguments.
2. If the tool result contains "payment_required": true, it includes the exact price, network, and pay_to address Qonoro requires.
3. Sign an x402 payment for that amount/network/address with your own wallet (Qonoro never sees or needs your private key).
4. Call the tool again with the same arguments plus payment_signature set to your signed value. The server forwards it to Qonoro, which validates and settles it, then returns the real result.

No wallet key, API key, or secret is required to run this MCP server itself -- the only configuration is which Qonoro base URL to call (defaults to production).

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

This repo has its own Conda environment (qonoro-mcp), same as every other Qonoro backend repo -- see docs/01_PROJECT_SETUP_GUIDE.md. Do not install this into a shared/base environment; it isolates the mcp/x402 SDK versions from whatever other Qonoro repos have installed.

Configuration

See .env.example. There are no secrets to fill in -- QONORO_BASE_URL defaults to https://api.qonoro.ai and only needs overriding for local testing against a dev server.

See AGENTS.md for the payment-bridge design rationale and the checklist for adding a new Qonoro agent to this server.

Links

• PyPI: https://pypi.org/project/qonoro-mcp/
• GitHub: https://github.com/QonoroAI/qonoro-mcp-server
• API: https://api.qonoro.ai \x00\x00\x00