Skip to main content

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

Project description

Qonoro Intelligence MCP Server

PyPI version Python

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: decision makers, competitors, sales signals, 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_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

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qonoro_mcp-0.7.0.tar.gz (13.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

qonoro_mcp-0.7.0-py3-none-any.whl (11.4 kB view details)

Uploaded Python 3

File details

Details for the file qonoro_mcp-0.7.0.tar.gz.

File metadata

  • Download URL: qonoro_mcp-0.7.0.tar.gz
  • Upload date:
  • Size: 13.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for qonoro_mcp-0.7.0.tar.gz
Algorithm Hash digest
SHA256 7b137be0e4ded5d756b023e355a79a784216109e8a53489e5028b0d921ea1c8c
MD5 c69a81a9fe3180a77fbb142bc6aa4888
BLAKE2b-256 7e88e0c2fdae7bfe43108178e1847aa5ae6d3d04e2a44a3cabb736e2f9f787a2

See more details on using hashes here.

File details

Details for the file qonoro_mcp-0.7.0-py3-none-any.whl.

File metadata

  • Download URL: qonoro_mcp-0.7.0-py3-none-any.whl
  • Upload date:
  • Size: 11.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for qonoro_mcp-0.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 bb638180416489618384c06fdd4df13ec77955736ffeda2b490d4c0fdab302ba
MD5 f8c019bc53999bad89f1cc91e73260f0
BLAKE2b-256 76bac149b420104ffc8b4c3511d20c651dd93f5f02693f5a83b8ef3e5501d91e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page