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

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.8.0.tar.gz (13.7 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.8.0-py3-none-any.whl (11.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: qonoro_mcp-0.8.0.tar.gz
  • Upload date:
  • Size: 13.7 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.8.0.tar.gz
Algorithm Hash digest
SHA256 b394d5faaf66ea5e75722f15a3f093d9002e254524c7ffd837c40a4254a6fe4f
MD5 4eacd04e1d4df0b2329a7ed037e7599c
BLAKE2b-256 1af1769276aa2c444f26dabef9c3ff395d336eb101bfd3bca022cb871f4efcc7

See more details on using hashes here.

File details

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

File metadata

  • Download URL: qonoro_mcp-0.8.0-py3-none-any.whl
  • Upload date:
  • Size: 11.8 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.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 72cdde7d8a738500e051247ffe2f90ca2d56d9b443fe66f79e4b83193cdecbe6
MD5 9ad3b4837e18954813bfaf3a0e79b65c
BLAKE2b-256 bc4298adbc912f605bfe8ab296374db8a1f3726696475f98f2900b8090a25e4d

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