How to Use the Kelkoo MCP in Claude Code

Q: How do I start the Kelkoo MCP Server in Claude Code?

Run claude mcp add --transport http kelkoo-mcp -- in your terminal. Make sure you place the transport flags before the server name. Verify the installation by typing claude mcp list.

Q: Can Claude Code pipe Kelkoo search results to a local file?

Yes. You can ask the CLI to run searchoffers and format the output as a CSV. It will execute the tool and write the file directly to your current working directory.

Q: How do I automate Kelkoo coupon discovery with Claude Code?

Write a bash script that prompts the agent to run searchcoupons for a specific region. You can schedule this script to run daily and push the active promo codes to a Slack webhook.

Query retail catalogs and publisher metrics directly from your terminal with Claude Code.

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 Claude Code

Create your Vinkius account to connect Kelkoo to Claude Code 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 Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate price scraping in the terminal

The `search_offers` tool lets you run bulk product queries straight from your command line. You pipe a list of keywords into Claude Code, and it executes the search against the retail database. It returns structured JSON that you can easily pass to jq or another shell utility. For deeper analysis, your agent loops through the results using `get_offer_details`. This pulls the granular shipping costs and stock status for every single item. You can run this headless script as a cron job to monitor competitor pricing overnight.

Map global retail markets with Claude Code

The `list_countries` tool outputs the exact geographic regions currently supported by the platform. You use this to validate your input parameters before kicking off a massive data pipeline. Claude Code checks this list and halts execution if a target locale goes offline. Once the region is validated, your terminal agent runs `list_merchants` to dump the active seller directory. You can track merchant churn by diffing yesterday's output against today's response. It gives you a raw, unfiltered view of the e-commerce market without leaving bash.

Pull affiliate metrics into CI/CD pipelines

The `get_reporting_summary` tool fetches your publisher earnings and traffic stats via standard HTTP transports. Claude Code can execute this tool inside a GitHub Action to verify affiliate link performance before a deployment. If the revenue drops below a threshold, the pipeline fails. You can also map out product verticals using the `get_category_tree` tool. Your CLI agent downloads the entire nested JSON structure and saves it to an S3 bucket. This MCP Server keeps your internal product databases perfectly synced with the upstream provider.

Setup guide

Set up Kelkoo MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see kelkoo-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Kelkoo transactions." It will automatically discover and invoke the available Kelkoo tools.

Terminal

claude mcp add --transport http kelkoo-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
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

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "kelkoo-mcp": {
      "type": "url",
      "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 Claude Code

Run `claude mcp add --transport http kelkoo-mcp -- ` in your terminal. Make sure you place the transport flags before the server name. Verify the installation by typing `claude mcp list`.

Yes. You can ask the CLI to run `search_offers` and format the output as a CSV. It will execute the tool and write the file directly to your current working directory.

Write a bash script that prompts the agent to run `search_coupons` for a specific region. You can schedule this script to run daily and push the active promo codes to a Slack webhook.

The server itself is just an API wrapper, so it works perfectly in headless environments. Claude Code handles the autonomous execution and tool calling without requiring any graphical interface.

This integration only transmits the specific keywords and country codes you pass to the search tools. The server has zero access to your environment variables, SSH keys, or local 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