# Kelkoo MCP for AI Agents AI Agent Connect

> Kelkoo connects your AI agent to a massive database of retail offers and shopping data across 39 countries. It lets your agent search for products, compare merchant prices in real time, and navigate complex retail catalogs. Use it to build shopping assistants that find the best deals or to pull market insights for e-commerce analysis.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_7mmkW1ysEdc7nZxhZN35YcVI7NwVUc7PtvsFE7Zb/ai-agent-connect
- **Tags:** price-comparison, retail-catalog, product-discovery, affiliate-marketing, market-intelligence, e-commerce-data

## Description

Imagine you're building a personal shopping assistant that needs to know exactly where to find the best price for a new laptop. Instead of hardcoding dozens of links, you can let your agent pull live data directly from a global retail network. This Connector gives your agent the eyes it needs to see millions of product offers across different regions. You can ask it to find a specific item in the UK, compare how different stores price it, or even hunt for active discount coupons to save money. It works by tapping into a rich catalog of categories and merchants, making it easy to build tools that understand how retail works on a large scale. When you add this to your setup on Vinkius, you're giving your agent a professional-grade data feed that handles the heavy lifting of price scraping and catalog navigation for you.

## Tools

### list_merchants
Get a list of all merchants operating in a specific country. This helps you see which retailers are active in a region.

### get_offer_details
Pull specific data points for a single product offer. Use this to see deep details on a specific item.

### get_reporting_summary
Access a summary of publisher performance and reporting data. It gives you a high-level view of market activity.

### search_offers
Search for products using keywords and a specific country code. This is the primary way to find live prices.

### list_categories
See all product categories available in a given country. It helps your agent understand local retail structures.

### get_category_tree
View the full hierarchical structure of the retail catalog. This is great for understanding how products are organized.

### list_countries
See every country currently supported by the Kelkoo network. Use this to check regional availability.

### search_coupons
Find active discount codes and promotional offers. Your agent can use this to hunt for the best deals.

## Prompt Examples

**Prompt:** 
```
Find the best price for a Sony PS5 in the UK.
```

**Response:** 
```
I've checked the latest offers for the Sony PS5 in the UK. Here are the best prices currently available:

| Merchant | Price | Status |
| :--- | :--- | :--- |
| **Amazon UK** | £479.99 | In Stock |
| **Currys** | £489.00 | In Stock |
| **Argos** | £499.00 | Low Stock |

Would you like me to look for any specific coupons for these stores?
```

**Prompt:** 
```
What are some active coupons for electronics in the US?
```

**Response:** 
```
I found several active coupons for electronics in the US market:

*   **TechStore**: 10% OFF your next purchase
*   **FashionHub**: Free Shipping on orders over $50
*   **GadgetWorld**: $20 off sitewide

Let me know if you'd like me to search for coupons for a specific brand!
```

**Prompt:** 
```
Show me the main shopping categories for France.
```

**Response:** 
```
The main shopping categories for Kelkoo France include:

*   **Informatique** (Computing)
*   **Image & Son** (Audio & Video)
*   **Electroménager** (Appliances)
*   **Mode** (Fashion)

I can also pull the full hierarchical tree if you need to see the sub-categories.
```

## Capabilities

### Search products across 39 countries
Your agent can find real-time product offers using specific keywords and region codes.

### Compare merchant prices
Get a side-by-side look at how different retailers price the same item.

### Navigate retail category trees
Explore the full hierarchical structure of product categories in any supported country.

### Find active discount coupons
Retrieve current promotional deals and coupons for various products.

### Pull market reporting summaries
Access high-level performance data for publisher reporting.

### List regional merchants
Identify which retailers are active and available in specific geographic locations.

## Use Cases

### Finding the cheapest electronics in France
A user wants to know the cheapest place to buy a TV in France. The agent uses search_offers with the fr code to find the best price.

### Building a deal hunting bot
A developer wants to build a Deal of the Day bot. The agent uses search_coupons to find active discounts for different products.

### Analyzing regional retail layouts
A market researcher needs to see how products are organized in Japan. The agent uses list_categories to see the local layout.

### Generating a list of UK retailers
A publisher wants to see which stores are available in the UK. The agent uses list_merchants to generate a list of retailers.

## Benefits

- Get real-time price data from millions of items across 39 countries using search_offers.
- Build smarter shopping bots by navigating complex retail structures with get_category_tree.
- Identify the best deals for users by pulling active promotions via search_coupons.
- Monitor market trends more accurately using get_reporting_summary for publisher insights.
- Quickly see which retailers are active in a region by using list_merchants.

## How It Works

The bottom line is you get live, global shopping data fed directly into your agent's workflow.

1. Subscribe to the Kelkoo MCP on Vinkius.
2. Provide your Kelkoo Shopping API v2 JWT Token in the configuration.
3. Ask your AI client to find products or compare prices.

## Frequently Asked Questions

**Can the Kelkoo MCP find products in my country?**
Yes, it covers 39 different countries. Your agent can search for products in regions like the US, UK, France, and many others using specific country codes.

**How does the Kelkoo MCP help with price comparison?**
It allows your agent to see offers from multiple merchants at once. This means you can quickly find the lowest price for a specific item without visiting every store yourself.

**Can I use the Kelkoo MCP to find discount codes?**
Yes, the tool includes a specific function to search for active coupons. Your agent can pull these deals to help users save money during their shopping experience.

**Is the retail catalog updated in real time?**
The Connector provides access to live product offers and merchant data. This ensures your agent is working with current information rather than cached or old prices.

**Can I use Kelkoo MCP for market research?**
Definitely. You can use it to list merchants in specific countries or explore category trees to understand how different regions organize their retail markets.

**Does the Kelkoo MCP require a lot of setup?**
Not at all. Once you provide your Kelkoo Shopping API v2 JWT Token, your agent can start searching for products and comparing prices immediately.

**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.