Qomvia

MCP server

Give your agent a checkout.

One endpoint to search every Qomvia Market shop, hold the best offer and send the buyer to pay.

Connect in 30 seconds HTTP API instead
ChatGPTClaude
agent → qomvia.com/api/mcp

user Bike helmet under CHF 100, ship to Zürich.

tools/call search_products

  • 1velo-shop.chCHF 92.30BEST
  • 2bikeparts.chCHF 96.80
  • 3helmhaus.chCHF 101.40

tools/call complete_checkout

→ "paymentUrl": "velo-shop.ch/pay/ord_1842"

agent Found it for CHF 92.30. Pay here.

1
Endpoint
10
Tools
30 min
Signed offer hold
0
Keys to start

Connect

One line of config. Every shop.

Streamable HTTP for Claude, ChatGPT, Cursor and any MCP client.

GET /api/mcp returns the descriptor; discovery at /.well-known/mcp.json.

{
  "mcpServers": {
    "qomvia": {
      "type": "http",
      "url": "https://qomvia.com/api/mcp"
    }
  }
}

01Find

Compare every shop in one tool call.

search_products returns ranked, signed offers at agent prices.

  • Ranked by landed price
  • Grade, delivery and returns
  • Hold it longer with extend_offer
Agent guideAbout Qomvia Market
offer_7Hq2 · signed for your agent

Velohelm Pro

velo-shop.ch · GTIN 7612345678901

Grade AQMP native

List
89.90
Agent price
85.40
Shipping
6.90 · 2 days
Landed
92.30
30-day returnsSeller: velo-shop.chHolds 30 minsig v1=9f2e…c41a

02Buy

From question to paid order.

Open a session, complete it, send the buyer to the merchant's checkout.

  • Merchant stays seller of record
  • Qomvia never takes the payment
  • Cancel any open session
See the checkout flowHow shops answer
tools/call · qomvia
  • toolsearch_products3 offers
  • toolget_offersigned
  • toolcreate_checkout_sessionopen
  • toolcomplete_checkoutpaymentUrl
  • toolget_checkout_sessionpaid

03Check

Know who's ready to sell.

Score any site's agent readiness from inside the conversation.

  • Live scan of any domain
  • The full rubric
  • Every failing check
What it measures
agent → qomvia.com/api/mcp

user Is yourbrand.com ready for agents?

tools/call get_ai_readiness_score

{

"domain": "yourbrand.com",

"score": 94,

"grade": "A",

"checks": [ 26 passed ],

"report": "qomvia.com/site/yourbrand-com"

}

agent Yes. Grade A, ready to buy from.

Tools

10 tools. One conversation.

Buy

Qomvia Market

  • search_products

    Search every shop listed on Qomvia Market in one call and get signed, time-limited offers. Prices are the merchant's own prices with an agent discount applied; the buyer always pays the merchant on the returned payment URL, never Qomvia.

  • get_offer

    Re-read an offer by id: merchant, product, agent price, shipping, landed price, terms and expiry.

  • extend_offer

    Extend an offer's validity once by its TTL. A second extension is refused.

  • create_checkout_session

    Open a checkout session on an offer: freezes the agent price, quantity and shipping. Qomvia never takes the payment; complete_checkout returns the merchant's payment URL.

  • get_checkout_session

    Read a checkout session's status, amounts and expiry.

  • complete_checkout

    Complete a checkout session and receive the merchant-hosted payment URL. The buyer pays the merchant there; Qomvia never takes payment for the goods.

  • cancel_checkout_session

    Cancel an open checkout session and release the offer.

Check

Agent readiness

  • get_ai_readiness_score

    Return the published AI-readiness score for a website: core score out of 100 (same checks for every site), grade, per-dimension breakdown, separate add-on scores (e.g. e-commerce) and the status of every measured check. Reads the cached public scan; use scan_website to force a fresh measurement.

  • scan_website

    Measure a website's AI-readiness now and return the score. Read-only HTTP requests only; a domain can be scanned once per hour and results become part of the public index.

  • list_readiness_checks

    List the rubric: every pack (core, e-commerce), its dimensions and the individual checks with why each one matters and how to fix it.

About the MCP server

What does the Qomvia MCP server do?+

It exposes Qomvia Market search and checkout plus Qomvia's agent-readiness scoring as Model Context Protocol tools, so an assistant can find, compare and buy a product or score a domain without leaving the conversation.

Does the MCP server need an API key?+

No. The endpoint is https://qomvia.com/api/mcp over streamable HTTP. Anonymous calls get 20 searches and 10 checkouts a minute and one fresh crawl per domain per hour; a qva_ agent key raises the Market limits.

Which clients work with it?+

Any MCP client that speaks streamable HTTP, including Claude Desktop, Cursor and OpenAI-compatible agent frameworks. A plain GET on the endpoint returns the server descriptor.

Can an agent buy through the MCP server?+

Yes. search_products compares every Qomvia Market shop, create_checkout_session and complete_checkout return the merchant's payment link, and the buyer pays the merchant directly.

Your agent already knows what to buy. Now it knows where.

Paste the config. Ask for a product.

Connect now Qomvia Market