How to Use the Klevu (E-commerce AI Search) MCP in Windsurf

Use Windsurf to connect your storefront to Klevu. Let Cascade chain product discovery, filtering, and recommendations automatically.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Klevu (E-commerce AI Search) MCP to Windsurf

Create your Vinkius account to connect Klevu (E-commerce AI Search) 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 Klevu (E-commerce AI Search) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous product search in Windsurf

Cascade handles the heavy lifting by mapping natural language queries to `search_keyword`. It identifies your intent and runs the request without you needing to manually verify the API schema. Windsurf reads your intent and chains `search_filtered` if you ask for specific attributes like size or color. It manages the entire request flow from the initial search to returning the refined product list.

Smart merchandising with Windsurf

You can pull category-specific data directly into your workspace using `search_category`. This lets you build dynamic storefront layouts that reflect real-time inventory and merchandising rules. Cascade updates your views by calling `search_sorted` when you need to reorder items based on price or relevance. It keeps your interface synced with the Klevu engine so your code always displays current data.

Context-aware recommendations for Windsurf

Get personalized product suggestions by invoking `search_recs` through the MCP Server. This tool identifies what to show next based on the user's current session or search history. Windsurf can also trigger `search_trending` to grab top-performing items for your homepage components. It automates the data retrieval so you focus on writing the front-end logic rather than managing API calls.

Setup guide

Set up Klevu (E-commerce AI Search) 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 Klevu (E-commerce AI Search) 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 Klevu (E-commerce AI Search) payment history." If connected, Cascade will call the Klevu (E-commerce AI Search) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "klevu-e-commerce-ai-search-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 Klevu. 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 Klevu (E-commerce AI Search) 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 Klevu (E-commerce AI Search) MCP in Windsurf

You connect the server in your MCP settings, and Cascade takes over. It auto-discovers the tools and executes them whenever you ask a natural language question about your product catalog.

Yes. You just ask Cascade to sort products, and it triggers `search_sorted` with your criteria. It handles the API parameters so you don't have to write the boilerplate.

It does. You can tell Cascade to fetch category-specific data, and it will use `search_category` to pull the right product set for your page templates.

That is exactly what Cascade does best. It chains sequences like `search_keyword` followed by `search_filtered` to give you a final, refined result set in one go.

Vinkius manages the connection via an endpoint token. Your catalog data, specifically product IDs and metadata, is transmitted over encrypted channels only when you explicitly request a search.

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