About kwery
kwery is a hosted remote MCP server for retrieving live product prices, offers, and trust scores from supported marketplaces. It is for assistants and their users comparing products by identifier or across sources.
Key features
- 01Fetch product offers from a marketplace
- 02Compare prices across up to five marketplaces
- 03Submit identifier batches for background lookup
- 04Check batch progress and retrieve paged results
- 05View supported sources and credit rates
Use cases
- 01Find the lowest available price for a product
- 02Compare an item across several marketplaces
- 03Price-check a large list of product identifiers
MCP support
Provides price lookup and batch tools, the `price_check` and `catalog_sweep` prompts, and the `kwery://sources` resource over Streamable HTTP. MCP clients connect to `https://api.kwery.co/mcp` and authenticate with an API key.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.kwery.co/mcpclaude mcp add --transport http co-kwery-price-data https://api.kwery.co/mcp{"mcpServers":{"co-kwery-price-data":{"type":"http","url":"https://api.kwery.co/mcp"}}}Open in Cursor{"servers":{"co-kwery-price-data":{"type":"http","url":"https://api.kwery.co/mcp"}}}Open in VS Code{"mcpServers":{"co-kwery-price-data":{"type":"http","url":"https://api.kwery.co/mcp"}}}{"mcpServers":{"co-kwery-price-data":{"serverUrl":"https://api.kwery.co/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://api.kwery.co/mcpAuth requiredTools
Details
From the project READMEkwery MCP server
Live prices, offers and trust scores from Amazon, Google Shopping, Idealo, eBay, Kaufland and more, as tools for your AI assistant. Ask in plain language, for example "Where is GTIN 4006381333962 cheapest in Germany?", and the assistant looks it up on the marketplaces live.
kwery is a hosted remote MCP server. There is nothing to install: point your client at the URL below and send your API key.
| Server URL | https://api.kwery.co/mcp |
| Transport | Streamable HTTP |
| Authentication | Your kwy_live_ API key in the x-api-key header (or Authorization: Bearer) |
| Registry | co.kwery/price-data in the official MCP Registry |
| Full guide | docs.kwery.co/guides/mcp |
Get an API key: sign up at kwery.co; the free plan's credits work with MCP too.
Connect
Replace kwy_live_... with your key.
Claude Code
claude mcp add --transport http kwery https://api.kwery.co/mcp \
--header "x-api-key: kwy_live_..."
Add --scope user to use it in every project.
Claude (claude.ai and Claude Desktop)
Customize → Connectors → + Add → Add custom connector
- Name
kwery, URLhttps://api.kwery.co/mcp, then Continue. - Authentication: No sign-in. Claude may tag "Sign in now" as Detected; the API key header below is what kwery uses instead.
- Add header: name
x-api-key, value your key, Required ticked. Then Add.
Cursor
.cursor/mcp.json (project) or ~/.cursor/mcp.json (all projects):
{
"mcpServers": {
"kwery": {
"url": "https://api.kwery.co/mcp",
"headers": { "x-api-key": "${env:KWERY_API_KEY}" }
}
}
}
VS Code
.vscode/mcp.json:
{
"inputs": [
{ "type": "promptString", "id": "kwery-api-key", "description": "kwery API key", "password": true }
],
"servers": {
"kwery": {
"type": "http",
"url": "https://api.kwery.co/mcp",
"headers": { "x-api-key": "${input:kwery-api-key}" }
}
}
}
Other clients
Any client that supports remote MCP servers over Streamable HTTP with a custom header: use
https://api.kwery.co/mcp and send x-api-key.
Tools
| Tool | Use it for | Cost |
|---|---|---|
get_product_offers | One product on one marketplace: price, offers, trust score | The source's credit rate |
compare_prices | One product on up to 5 marketplaces, ranked by price | The sum of the sources that returned a result |
submit_batch | Up to 1,000 identifiers on one marketplace as a background job | Estimate first, charged per result |
get_batch_status | Progress of a batch job | Free |
get_batch_results | Results of a finished job, paged | Free |
list_sources | Marketplaces, countries, identifier types and credit rates | Free |
get_account | Plan, credit balance and credits used | Free |
Identifiers: GTIN/EAN, ASIN (Amazon), the marketplace's own product ID, and PZN where supported.
Prompts price_check and catalog_sweep and the resource kwery://sources are included.
lowest_price is the cheapest new, in-stock offer including shipping. Every result carries a
trust score; below 0.7 means a person should look before
acting on it.
Example prompts
- "Where is GTIN 4006381333962 cheapest in Germany right now?"
- "What does ASIN B08R57HZ4Z cost on Amazon Germany, including shipping?"
- "Price these 200 GTINs on Kaufland DE, show me the credit estimate first."
- "How many kwery credits do I have left?"
Pricing and limits
MCP calls use the same credits as the kwery API. Cached results and failed lookups are free. Lookups wait up to 50 seconds; if offers are still loading, the assistant gets what has arrived and can fetch the rest later. More in the guide.
Support
This repository holds the server's documentation and registry metadata. The server itself is hosted by kwery.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.