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

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.


Links

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.5.1.tar.gz (12.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.5.1-py3-none-any.whl (10.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: qonoro_mcp-0.5.1.tar.gz
  • Upload date:
  • Size: 12.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.5.1.tar.gz
Algorithm Hash digest
SHA256 00c90bd89b53e6e574697e6fe098ccfc338f5458130f4fb6a3246e81ce855659
MD5 e076d9d49e604b6b3062f5c130d98891
BLAKE2b-256 ad4f875698a9004664ce8067c1ef5e83222211cc7bb25eb19ec04e0d204cf956

See more details on using hashes here.

File details

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

File metadata

  • Download URL: qonoro_mcp-0.5.1-py3-none-any.whl
  • Upload date:
  • Size: 10.6 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.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 62d8c532a9e315f440483d3500e6a7cfa5ae35a937a822b0c83e633c6a0802f9
MD5 b2f26f682c97e65cb3bd6b45d4cbd0dd
BLAKE2b-256 b1b9ab93e7be8031c6c83d6beaa69399c5c190ff5143730dfed93a5a4f4b1296

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