qonoro-mcp 0.9.0

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

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

Tool	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 intelligence: tech stack, hosting provider, email provider, registrar, and 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
qonoro_outbound_personalize	POST /v1/outbound/personalize	$0.75 USDC	Personalized B2B outbound message: subject line, opening, body, CTA, personalization hooks, and signals used
qonoro_domain_resolver	POST /v1/domain-resolver/resolve	$0.02 USDC	Resolve a company name to its official domain. Returns domain, confidence score, and alternatives
qonoro_kyb_verify	POST /v1/kyb/verify	$0.75 USDC	KYB entity verification: registration status, OFAC sanctions screening, beneficial ownership, risk score, and proceed/review/reject recommendation
qonoro_email_validate	POST /v1/email/validate	$0.005 USDC	Validate email deliverability: risk score, quality label, and deliverability status. Sub-second
qonoro_naics_classify	POST /v1/naics/classify	$0.02 USDC	Classify a company to its NAICS 2022 and SIC code with confidence score and matched keywords. Sub-second
qonoro_phone_validate	POST /v1/phone/validate	$0.01 USDC	Validate a phone number: E.164 format, country, line type (mobile/landline/VOIP/toll-free), risk score. Sub-second
qonoro_url_health	POST /v1/url/health	$0.01 USDC	Check URL reachability: HTTP status, redirect chain, SSL validity and expiry, response time. Sub-second
qonoro_address_normalize	POST /v1/address/normalize	$0.02 USDC	Parse and normalize a postal address to USPS format with structured components and confidence score. Sub-second

---

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