How to Use the Kelkoo MCP in Mastra AI

Q: How can I build a Mastra AI agent to monitor Kelkoo prices?

Create a workflow that calls the searchoffers tool on a schedule. Mastra AI will handle the scheduling and retries, and you can define what happens next—like logging the price or alerting you if it drops.

Q: Can a Mastra AI workflow automatically fetch my Kelkoo reporting summary?

Yes, that's a perfect use case. Schedule an agent to call getreportingsummary, and then use Mastra's conditional logic to analyze the results and trigger different actions based on performance metrics.

Q: How do I get the full category structure?

Your Mastra agent can call the getcategorytree tool. This gives you the complete, nested category data for a country, which you can then process or store.

Build reliable e-commerce bots on Kelkoo with Mastra AI. Automate price checks, reporting, and catalog updates with resilient workflows.

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 Mastra AI

Create your Vinkius account to connect Kelkoo to Mastra AI 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 Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Resilient Price Checks

The `search_offers` tool lets your Mastra agent find current prices for any product. You can set up a workflow to run this search on a schedule, building a real-time price tracker. No more writing your own cron jobs. Here's the thing: if the Kelkoo API flakes or a product is out of stock, Mastra's built-in exponential backoff handles retries automatically. Your agent just keeps trying until it gets the data, making your monitoring bot far more reliable.

Build Conditional Reporting Workflows

Schedule a Mastra AI agent to call `get_reporting_summary` every morning. This tool gives you a snapshot of your publisher performance. From there, you can build a workflow with real business logic. For example, if affiliate revenue is down, automatically trigger a new task for the agent to use `search_coupons` and find fresh deals to promote. If performance is good, the workflow can simply send a success notification to Slack. You define the rules.

Manage Catalogs with a Mastra AI Bot

You can create a Mastra AI workflow to keep an external system, like your own database, in sync with Kelkoo. Have the agent periodically call `list_merchants` and `get_category_tree` to check for any changes or new additions. This is where Mastra's `requireToolApproval` feature comes in handy. You can configure the workflow to pause and wait for a human to approve adding a new merchant before your bot proceeds. It's automation with a manual override.

Setup guide

Set up Kelkoo MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Kelkoo tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "kelkoo-mcp-client",
  servers: {
    "kelkoo-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Kelkoo Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Kelkoo tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Kelkoo transactions"
);
console.log(result.text);

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 Mastra AI

Create a workflow that calls the `search_offers` tool on a schedule. Mastra AI will handle the scheduling and retries, and you can define what happens next—like logging the price or alerting you if it drops.

Yes, that's a perfect use case. Schedule an agent to call `get_reporting_summary`, and then use Mastra's conditional logic to analyze the results and trigger different actions based on performance metrics.

Absolutely. Your agent can access all the tools from this MCP server. You can build a workflow where it first uses `search_offers` and then, if the price is high, follows up by calling `search_coupons`.

Your Mastra agent can call the `get_category_tree` tool. This gives you the complete, nested category data for a country, which you can then process or store.

Your agent only interacts with public Kelkoo catalog data like offers, merchant lists, and categories. Vinkius manages the secure, authenticated connection, and the server instance handling your requests is temporary and isolated.

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