MCP Server

    Live Price Data in Your AI Assistant

    Connect kwery to ChatGPT, Claude, Gemini, Grok, Perplexity, Cursor, VS Code or any app that supports remote MCP. Ask for live prices, offers and trust scores by GTIN.

    https://api.kwery.co/mcp

    Tools

    Seven Tools Mapped to the kwery API

    One API key for all of them, so the data and the credits are the same as in the API.

    • get_product_offersLive price, offers and trust score for one product on one marketplaceCost: Source rate
    • compare_pricesOne product on up to 5 marketplaces, ranked by priceCost: Sum of sources
    • submit_batchUp to 1,000 products on one marketplace as a background job. Shows the credit estimate first and spends nothing until you confirmCost: Per result
    • get_batch_statusHow far a batch job has gotCost: Free
    • get_batch_resultsThe finished results, page by pageCost: Free
    • list_sourcesMarketplaces, countries, identifier types and credit ratesCost: Free
    • get_accountYour plan, credit balance and credits usedCost: Free

    Identify products by GTIN, ASIN or the marketplace's own ID. Two ready prompts, price_check and catalog_sweep, appear in clients that show MCP prompts.

    Prompts

    Ask in Plain Language, Get Matched Offers

    ClaudeSample data
    What's the cheapest offer for EAN 4548736151757 on Amazon, idealo and Google Shopping in Germany right now?
    compare_prices · 3 marketplaces
    • idealo€279.00Shipping Free0.94
    • Amazon€284.99Shipping Free0.97
    • Google Shopping€289.90Shipping €4.990.88
    CursorSample data
    Check these 200 EANs on idealo and list every product where we're not the cheapest shop.
    submit_batch · 200 identifiers
    • EAN …1757€279.00Shipping Free0.94
    • EAN …0428€42.50Shipping €3.950.91
    • EAN …8812€119.00Shipping Free0.86
    ChatGPTSample data
    Which of these offers have a trust score below 0.7?
    get_batch_results · page 1
    • EAN …3307€9.99Shipping €5.900.52
    • EAN …6144€64.00Shipping Free0.61
    • EAN …2290€18.40Shipping €2.990.68

    Setup

    One Server URL for Every AI App

    Sign up, copy your API key from the dashboard, add the server. The full steps for every client are in the MCP guide.

    In the app

    1. 01Open Customize → Connectors → + Add → Add custom connector.
    2. 02Name it kwery, enter https://api.kwery.co/mcp, click Continue.
    3. 03Under Authentication choose "No sign-in". Under Request headers add x-api-key with your key, keep Required ticked, click Add.

    On Team and Enterprise plans an owner adds kwery once under Organization settings → Connectors, and the team shares that key and its credits.

    Response

    Every Answer Carries a Trust Score

    The same data as the API, so the assistant can tell whether to trust a price before anyone acts on it.

    • Lowest price

      The cheapest new, in-stock offer including shipping, with suspect offers left out. A second field covers used and open-box offers.

    • Offers

      Every offer with seller, price, shipping and stock.

    • Trust score

      On every result. Below 0.7, a person should check it first.

    • Not found

      When a product isn't listed, the assistant is told so instead of guessing.

    compare_prices · sample
    {
      "tool": "compare_prices",
      "gtin": "4548736151757",
      "country": "DE",
      "lowest_price": {
        "source": "idealo",
        "price": 279.00,
        "shipping": 0,
        "currency": "EUR",
        "trust_score": 0.94
      },
      "lowest_price_any_condition": { "source": "amazon", "price": 249.00 },
      "results": [
        { "source": "idealo", "offers": 14, "trust_score": 0.94 },
        { "source": "amazon", "offers": 6, "trust_score": 0.97 },
        { "source": "google_shopping", "offers": 9, "trust_score": 0.88 }
      ]
    }

    Credits

    Billed Like the API, Free When a Lookup Fails

    The MCP server uses your normal kwery credits at each marketplace's rate. The free plan works too.

    01

    Marketplace Rates

    Each lookup costs the same credits as the matching API call, at that marketplace's rate.

    02

    Free When It Fails

    Cached results and failed lookups cost 0 credits.

    03

    Estimate Before Batches

    Batches show a credit estimate first and spend nothing until you confirm.

    Directories

    Find kwery in the MCP Directories

    Use Cases

    Where Live Prices Change the Answer

    If the data behind an answer is stale or matched to the wrong product, the assistant recommends the wrong offer.

    AI Shopping Assistants

    Assistants quote prices from comparison sites, marketplaces and Google Shopping. Live, GTIN-matched data keeps those answers current.

    Merchant Agents

    Agents that check your own catalog against the market need the right product, not a lookalike. Trust scores flag what a person should review.

    Questions From Your Team

    Anyone with an AI assistant can ask for a price check in plain language, using the same data and credits as the API.

    FAQ

    Common Questions About the MCP Server

    Setup, costs and limits for using kwery in AI assistants.

    Browse AI Agent FAQs

    ChatGPT, Claude (on the web, Claude Desktop and Claude Code), Gemini, Grok, Perplexity, Cursor and VS Code. ChatGPT and Perplexity connect by signing in to kwery; the others use your API key. Any other app that supports remote MCP with OAuth or a custom header works too.

    No. Add kwery as a custom connector and sign in with your kwery account. Usage comes out of that account's credits.

    The same credits as the API, at each marketplace's rate. Cached results and failed lookups are free. Free-plan credits work too.

    Batches show a credit estimate first and spend nothing until you confirm.

    On the free plan, compare_prices is limited to 30 calls per minute. A batch takes up to 1,000 products.

    All kwery sources except AliExpress, which is available through the REST API. In Germany, if you don't name any, kwery checks Amazon, idealo and Google Shopping.

    Live Prices in Your AI Assistant

    Sign up, copy your API key, add the server.

    Free Tier Available
    Global Scale