How to Use the Kelkoo MCP in Windsurf

Q: How do I install the Kelkoo MCP Server in Windsurf?

Edit /.codeium/windsurf/mcpconfig.json and add the server details under the mcpServers object. You can also use the Settings UI under Cascade to add it visually. Click refresh in the MCP panel when you finish.

Q: Can Windsurf automatically find the cheapest Kelkoo offers?

Yes. Cascade will run searchoffers to get a list of products, then loop through getofferdetails to compare prices. It does this autonomously based on your initial prompt.

Q: Why isn't Windsurf finding any Kelkoo coupons for my search?

The searchcoupons tool depends on active merchant promotions in the specified country. If listmerchants shows a retailer but no coupons return, they simply do not have active affiliate discounts right now.

Give Windsurf direct access to millions of retail offers and categories across global merchants.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Kelkoo MCP to Windsurf

Create your Vinkius account to connect Kelkoo to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Kelkoo with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Let Cascade build price comparison tables

The `search_offers` tool queries the Kelkoo database for specific products using a keyword and country code. You just tell Windsurf what you want to buy, and Cascade handles the rest. It pulls the initial list of matches without you needing to manually paginate through results. Once it has the broad matches, Cascade fires off `get_offer_details` to grab the exact pricing, shipping costs, and merchant info. Your agent formats this raw JSON into a clean markdown table right in your editor. You get a direct view of the market without leaving the IDE.

Map retail catalogs with this MCP Server

The `list_countries` tool defines the geographic boundaries of your search before you even start pulling data. Cascade uses this to validate regions before it runs `list_categories` to pull the top-level retail taxonomy. If you need a deep dive into a specific vertical, your agent grabs the exact hierarchy. That deeper dive happens through `get_category_tree`, which dumps the entire nested structure of a product group. Windsurf reads this tree and maps out the exact navigation paths for a mock storefront or data pipeline you happen to be building.

Pull merchant discounts and reporting stats

The `list_merchants` tool shows you exactly who is selling what in a specific country. Cascade combines this with `search_coupons` to find active discount codes for those specific retailers. You don't have to guess which stores are running promos right now. For affiliate developers, the `get_reporting_summary` tool pulls your publisher metrics directly into the workspace. Windsurf can read your earnings and click-through rates, then automatically generate a weekly performance summary file.

Setup guide

Set up Kelkoo MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Kelkoo MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Kelkoo payment history." If connected, Cascade will call the Kelkoo tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "kelkoo-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Kelkoo. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Kelkoo now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Kelkoo MCP in Windsurf

Edit `~/.codeium/windsurf/mcp_config.json` and add the server details under the `mcpServers` object. You can also use the Settings UI under Cascade to add it visually. Click refresh in the MCP panel when you finish.

Yes. Cascade will run `search_offers` to get a list of products, then loop through `get_offer_details` to compare prices. It does this autonomously based on your initial prompt.

The system supports multiple regions, but the exact list changes. Cascade can run the `list_countries` tool to get the live, currently supported locales for your query.

The `search_coupons` tool depends on active merchant promotions in the specified country. If `list_merchants` shows a retailer but no coupons return, they simply do not have active affiliate discounts right now.

No. This MCP server only handles outbound HTTP requests for product pricing, merchant lists, and reporting summaries. It never touches your local source code, environment variables, or file system.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript