# Kelkoo MCP MCP > Kelkoo connects your AI agent to millions of product offers and retail catalogs globally. Instantly search for products by keyword, compare real-time prices across multiple merchants, track coupons, and explore category hierarchies from 39 countries—all through natural conversation. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** price-comparison, retail-catalog, product-discovery, affiliate-marketing, market-intelligence, e-commerce-data ## Description This MCP lets you query vast amounts of e-commerce data without ever visiting a website. You can ask your agent to find 'new headphones' in the UK or compare the price of a specific laptop model across three different stores, all before you finish writing the prompt. It pulls structured pricing details and merchant names directly into your workflow. If you're building any kind of shopping assistant or market intelligence tool, this connector is essential. Since Vinkius hosts over 4,000 MCPs in one place, connecting your agent here means instant access to massive global data sets like this one. ## Tools ### list_categories Shows all major product categories within a single, specified country. ### get_category_tree Retrieves a complete map of all product categories available in the catalog. ### list_countries Lists every supported country code that the catalog covers. ### search_coupons Finds active discount coupons for products based on keywords or expiration dates. ### list_merchants Retrieves a list of all merchants operating within a given country. ### get_offer_details Pulls specific details for one product offer when you already know its ID. ### get_reporting_summary Generates a summary report of the publisher's performance and market data over time. ### search_offers Searches and returns current product offers using a country code and search keyword. ## Prompt Examples **Prompt:** ``` Search for 'iPhone 15' offers in the UK on Kelkoo. ``` **Response:** ``` I've searched Kelkoo UK and found several offers for 'iPhone 15'. Prices start from £799.00 at 'Amazon UK' and £815.00 at 'Currys'. Would you like more details? ``` **Prompt:** ``` List all shopping categories available in France. ``` **Response:** ``` I've retrieved the categories for Kelkoo France. Major categories include 'Informatique', 'Image & Son', 'Electroménager', and 'Mode'. ``` **Prompt:** ``` Find active coupons for the US market. ``` **Response:** ``` I found 12 active coupons for Kelkoo US, including '10% OFF at TechStore' and 'Free Shipping on orders over $50 at FashionHub'. ``` ## Capabilities ### Find products anywhere Search for product offers using keywords and specified categories across multiple countries. ### Compare real-time pricing Retrieve detailed price listings and merchant names for specific items, making direct comparisons easy. ### Map the retail structure Browse through the entire e-commerce category tree to pinpoint exactly where a product fits in the market. ### Track discounts and deals Search for active discount coupons or promotional offers available right now. ### Get market summaries Pull aggregate performance reports, including supported country lists and general market insights. ## Use Cases ### A content writer needs to build a guide for new tech purchases. Instead of visiting Amazon US, then UK, then Germany, the agent runs `search_offers` three times—once for each country and using the same keyword. It collects all price points and presents them in a single comparison table. ### An analyst needs to track regional market growth. The agent first calls `list_countries` to see where Kelkoo operates, then uses `get_reporting_summary` for the top three regions to understand sales performance trends before advising a client. ### A developer is building an assistant that suggests deals. The agent lists categories using `list_categories`, lets the user pick 'Electronics', then runs `search_coupons` limited to that category, ensuring the suggested deal is relevant. ### A researcher needs to confirm a product's full retail placement. The agent starts by calling `get_category_tree`, navigates down to 'Kitchen Appliances', then uses `list_merchants` within that category scope to see which stores sell it. ## Benefits - You don't have to manually check multiple sites. By using `search_offers`, your agent pulls aggregated data on products and pricing from dozens of merchants in one go. - Mapping the market is easy. Running `get_category_tree` gives you the entire structure, letting you guide users even if they aren't sure what they want yet. - Keep your audience saving money. Using `search_coupons` lets your agent find and present active discounts for specific products or general categories. - Speed up market research. If you need to know which countries are covered, simply run `list_countries` instead of guessing the supported region. - Go deep into data with `get_offer_details`. Once you identify a promising product ID, this tool gives you all the necessary specs and pricing info in one shot. ## How It Works The bottom line is, you tell your AI client what market data you need, and the MCP handles all the complex API calls to get it for you. 1. Subscribe to this MCP and provide your Kelkoo Shopping API v2 JWT Token. 2. Your AI client then uses the token to execute a specific request, like searching for product offers or listing countries. 3. The agent gets back clean, structured data (like price lists and category paths) that it passes right into your conversation. ## Frequently Asked Questions **How do I use search_offers with Kelkoo?** You must provide both a country code (like 'us') and a specific keyword. This ensures the agent knows exactly where to look for product data. **Can list_countries help me target my market?** Yes. Running `list_countries` gives you the full, up-to-date roster of all supported regions before you start building your comparison logic. **Does get_category_tree show every product I can find?** No, it shows the entire hierarchical category map. You then use `list_categories` to see the major sections available for a specific country within that structure. **What is the difference between search_offers and get_offer_details?** Use `search_offers` when you are looking broadly (e.g., 'laptops in France'). Use `get_offer_details` only when you already have a specific product ID. **When I use list_merchants, what kind of API token do I need to authorize my agent?** You must provide your Kelkoo Shopping API v2 JWT Token. This specialized token handles all access and ensures your agent can retrieve merchant data securely, maintaining connection integrity across calls. **What information does get_offer_details provide beyond just the current price?** It returns comprehensive details about a single offer. You get not only the cost but also the merchant's full name, specific product identifiers, and rich descriptive metadata that helps your agent understand the context of the purchase. **What metrics does get_reporting_summary return for publisher performance?** This tool pulls key summary statistics specific to your account. It delivers high-level data on market reach and overall activity, letting your agent quickly assess business performance without needing to analyze thousands of individual records. **Are there any usage limits or rate limits when running search_coupons?** Yes, the API enforces rate limiting to ensure platform stability. If your agent makes too many calls in a short time window, you will receive an explicit error code. You'll need to build backoff logic into your workflow. **In which countries can I search for offers?** Kelkoo supports search across 39 countries. Use the `list_countries` tool to see the full list of supported regions and their codes. **Can I filter results by specific merchants?** Yes, you can list available merchants for a country using `list_merchants` and then refine your search or explore specific merchant catalogs. **Is it possible to search for discount coupons?** Absolutely. Use the `search_coupons` tool with a country code to find active promotional deals and discounts.