Metadata-Version: 2.4
Name: qonoro-mcp
Version: 0.8.0
Summary: MCP server exposing Qonoro's x402 intelligence agents as tools for any MCP-compatible AI agent client.
Project-URL: Homepage, https://qonoro.ai
Project-URL: Repository, https://github.com/QonoroAI/qonoro-mcp-server
Author: Qonoro
License: MIT
Keywords: agents,intelligence,mcp,qonoro,x402
Requires-Python: >=3.10
Requires-Dist: httpx>=0.28.1
Requires-Dist: mcp>=1.0.0
Requires-Dist: x402[mcp]>=2.12.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# Qonoro Intelligence MCP Server

[![PyPI version](https://img.shields.io/pypi/v/qonoro-mcp)](https://pypi.org/project/qonoro-mcp/)
[![Python](https://img.shields.io/pypi/pyversions/qonoro-mcp)](https://pypi.org/project/qonoro-mcp/)

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:

```json
{
  "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 |

---

## 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

```powershell
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