Klevu (E-commerce AI Search) MCP. Control product discovery—from keywords to trends.
Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Klevu provides AI-driven e-commerce search, letting you run sophisticated product discovery from your agent. You can execute high-relevancy keyword searches across your entire catalog; audit category merchandising paths; and apply complex filters like color, size, or brand to narrow results down instantly.
What your AI agents can do
Search autocomplete
Gets real-time suggestions for search terms as a user types into the search bar.
Search category
Retrieves all products assigned to a specific, defined category page path.
Search filtered
Runs a focused search by applying explicit attributes like color, size, or brand filters.
Run a general search across your entire product catalog using natural language keywords.
Use specific criteria—like brand or size—to narrow down the result set from any search query.
Retrieve products associated with a defined category path to audit how items are displayed in that section of the site.
Fetch suggested products based on behavioral data, such as what's trending or frequently bought together.
Send custom JSON structures directly to the Klevu API for deeply customized query testing.
Ask AI about this MCP
Supported MCP Clients
Waiting for input…
Klevu (E-commerce AI Search) MCP Server: 10 Tools
Use these ten tools to run complex e-commerce queries—from basic keyword searches to advanced JSON payloads—all through your natural conversation with the agent.
019d75c1search autocomplete
Gets real-time suggestions for search terms as a user types into the search bar.
019d75c1search category
Retrieves all products assigned to a specific, defined category page path.
019d75c1search filtered
Runs a focused search by applying explicit attributes like color, size, or brand filters.
019d75c1search keyword
Performs a general product search across the catalog using natural language keywords.
019d75c1search pagination
Retrieves results for a query, allowing you to cycle through multiple pages of products.
019d75c1search product id
Gets all details for a single product by knowing its unique catalog ID number.
019d75c1search raw
Executes any custom search payload you build using raw JSON against the Klevu API.
019d75c1search recs
Fetches recommended products based on behavioral data and machine learning models.
019d75c1search sorted
Runs a keyword search, but lets you specify the exact order the results should appear in (e.g., by price).
019d75c1search trending
Views which products are currently spiking in popularity and relevance across the store.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Klevu (E-commerce AI Search), then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
You're connecting Klevu to your agent. This server lets you ditch basic site search and actually take control of product discovery across your whole catalog. You gotta run sophisticated searches that feel natural, whether you're auditing merchandising paths or just trying to find a specific widget.
When you start talking about products, the system doesn't guess; it pulls data directly from ten distinct methods. You can use search_keyword to run a general product search across your entire catalog using natural language keywords, giving you high-relevancy results right out of the gate.
Before you even type anything, you get help with search_autocomplete, which grabs real-time suggestions for search terms as a user types into the bar. If you need to check how items are displayed in a specific section, you use search_category to retrieve all products assigned to that defined category page path, letting you audit merchandising rules exactly where they live.
When your general keyword search gets too broad, you refine it immediately using search_filtered. This tool runs a focused search by applying explicit attributes—you can narrow the results down instantly by specific filters like color, size, or brand. You'll also use search_sorted, which runs a keyword search but lets you dictate the exact order the results should appear in; for example, you can make sure everything is sorted by price.
Since catalogs are huge, you gotta handle volume with search_pagination. This tool retrieves result sets for any query and allows your agent to cycle through multiple pages of products so you never hit a dead end. If all that fails, or if the search structure gets really weird, you can bypass everything and use search_raw.
This executes any custom search payload you build using raw JSON directly against the Klevu API for deeply customized query testing.
For pinpoint accuracy, you've got search_product_id. If you know a product’s unique catalog ID number, this tool gets all the specific details for that single item. You don't have to guess; you just check the ID and get the full record.
On top of finding what exists, your agent can predict what people want next. search_recs fetches suggested products based on behavioral data and machine learning models—it shows what shoppers might like or frequently buy together. You also use search_trending, which views exactly which products are currently spiking in popularity and relevance across the whole store, giving you insight into seasonal spikes.
You're not limited to finding things by text or category structure; your agent can build a complex query using search_filtered for color, size, and brand simultaneously. You pull product lists from defined paths using search_category, and then you narrow those results down further with attributes via search_filtered. The entire process is designed to take vague user intent—like 'nice shoes'—and turn it into a precise list of inventory, page by page, sorted exactly how you want it.
You can get the full product record using search_product_id regardless of whether it was found through a keyword search via search_keyword, or if your agent is following up on recommendations pulled from search_recs. The system handles both general searches and highly structured ones, ensuring you always see the most current data available.
How Klevu (E-commerce AI Search) MCP Works
- 1 Subscribe to this server and provide your Klevu Search URL and API Key.
- 2 Connect your AI client (Claude, Cursor, etc.) to the MCP Server.
- 3 Ask your agent a question like, 'Show me waterproof jackets sized large'—the agent runs
search_filteredusing your credentials.
The bottom line is: you use natural language conversation with your AI client to run complex e-commerce queries that normally require writing and executing API code.
Who Is Klevu (E-commerce AI Search) MCP For?
Digital Merchandisers who waste time checking category paths manually; E-commerce Developers needing to test search relevance without Postman; Data Analysts monitoring product trends for market opportunities. If your current site search feels basic, this is for you.
Audits the display logic and product rankings within specific category paths by running search_category via natural conversation.
Tests search relevance and complex API results, bypassing manual Postman setups using tools like search_raw.
Monitors product performance by running queries to track trending items (search_trending) or identifying catalog gaps.
What Changes When You Connect
- Deeply audit merchandising logic. Don't just assume a category page is correct; use
search_categoryto pull the exact list of products displayed for that specific path, letting you validate your rules instantly. - Stop guessing at product relationships. Use
search_recsto fetch curated recommendations—whether it’s 'visually similar' or 'frequently bought together'—giving your agent concrete data points for cross-selling suggestions. - Pinpoint exact products without guesswork. If you have a specific SKU, use
search_product_idto pull the full details instantly, skipping keyword searching entirely and saving query steps. - Run complex searches that usually require multiple API calls. Combine filtering (e.g., brand + size) with keywords using
search_filteredin one go. It keeps your agent workflow tight. - Stay ahead of market shifts. Use
search_trendingto see which items are spiking right now, and cross-reference that data withsearch_keywordto understand why they're suddenly popular.
Real-World Use Cases
Checking for product gaps in a new collection
A merchandiser is launching a 'Fall Outerwear' category. Instead of manually clicking through the entire section, they ask their agent to run search_category. The agent returns the full list and shows missing high-margin items that need tagging or linking.
Validating search ranking logic
A developer needs to test if 'hiking boots' are correctly sorted by price ascending. They run search_keyword combined with the search_sorted tool, confirming that the API response respects their custom sorting order before pushing code live.
Investigating a sudden drop in sales for one item
A data analyst notices Item X's visibility is low. They use search_filtered by Brand A and Size M, then run search_recs. If the recommendations don't include Item X, they know the problem isn't inventory—it's discovery.
Building a custom data pipeline
An advanced user needs to check product details and trending status simultaneously. They use search_raw to execute a complex JSON payload, combining ID lookup with global trend data in one API call sequence.
The Tradeoffs
Searching everything via keywords
The user asks the agent: 'Show me all blue shirts for men that are also on sale.' If only search_keyword is used, the results will be too broad or inaccurate.
→
Don't rely only on keywords. Use search_filtered to explicitly apply attributes like color='blue' and size='medium'. Then, use search_keyword for the general term 'shirts.' This combination gives you precision.
Forgetting pagination
The user runs a search query (search_keyword) and only sees the first 20 results. They assume those are all the options, missing dozens of available products.
→
Always check for more results by running search_pagination after your initial keyword search. This ensures your agent retrieves every page of product listings.
Over-engineering a simple lookup
Instead of finding one specific jacket, the user asks 'What kind of jackets are available?' which requires massive data retrieval and is slow.
→
If you know the exact product ID, skip all the searching. Use search_product_id to pull the details immediately. It's faster, cleaner, and always more reliable.
When It Fits, When It Doesn't
Use this server if your e-commerce discovery requires deep context—if you need to test how merchandising rules affect product display paths (search_category), or if you constantly have to combine multiple filters (brand, color, size) with a keyword search. This is for systems that demand API-level control without forcing developers into writing boilerplate code.
Don't use this if your primary goal is just basic site navigation; simple searches are fine with standard client tools. Also, don't default to search_raw unless you know exactly what JSON payload you need—it’s powerful but requires knowing the API schema. If you only need to check product details by ID, stick to search_product_id; it keeps your prompts clean and focused.
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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Finding a specific product shouldn't involve three different tabs.
Today, checking if a product exists in a certain category often means jumping into the admin panel, navigating to 'Apparel,' then clicking 'Jackets,' and finally manually verifying that the correct sub-category filters are applied. It's a multi-step process with high failure points.
With this MCP server, you just tell your agent: 'Check the 'Outdoor Gear' category for all rain jackets.' The agent runs `search_category`, returning the precise product list and structure in one clean conversational step.
The Klevu (E-commerce AI Search) MCP Server delivers total search control.
Manual API calls force you to write code for every single query—whether it's a simple keyword check, or a complex filter combining brand and size. You waste time setting up headers, endpoints, and JSON bodies just to get results.
The server abstracts that complexity away. Your agent handles the mechanics, letting you talk about 'Show me all running shoes under $100.' The result is immediate, accurate product data, without writing a single line of integration code.
Common Questions About Klevu (E-commerce AI Search) MCP
How do I search by brand AND color simultaneously using search_filtered? +
You pass both attributes directly to search_filtered. For example: 'Filter results for Brand X and Color Blue.' The tool handles combining those explicit facets into one accurate query.
What is the difference between search_keyword and search_raw? +
search_keyword lets you use natural language (e.g., 'best waterproof jackets'). search_raw requires you to write a structured JSON payload, giving you absolute control over deeply nested API parameters.
Can I find out what products are trending using search_trending? +
Yes, that's exactly what it does. Use search_trending to get a list of currently popular items and view their relevance scores across the entire catalog.
I need product details for one item—should I use search_product_id or search_keyword? +
If you know the ID, always use search_product_id. It's faster and more direct. If you only have a description (like 'blue running shoe'), then run search_keyword first to get the ID.
How does `search_autocomplete` handle live user input for optimal UX? +
It provides instant suggestions as a user types. This ensures your agent can maintain smooth, responsive navigation that mimics the best e-commerce experience.
When should I use `search_category` specifically for merchandising audits? +
Use this when you need to check the exact product lineup displayed on a specific smart category path. It lets you verify if your site's display rules and configured navigation are working correctly.
Can `search_recs` fetch different types of recommendations, like 'frequently bought together'? +
Yes, it fetches multiple ML-driven product sets. The tool handles visually similar items, frequently bought together groupings, and general top sellers.
Why would I need to use `search_raw` instead of a standard search function? +
You use this when you need total control over the query structure. It executes custom JSON payloads for deeply nested or non-standard API requirements.
Can I test how different filters affect search results through my agent? +
Yes. Use the search_filtered tool by providing a query and specific facet values (e.g., 'color': 'red'). Your agent will return the filtered result set, allowing you to verify that your indexing and category mappings are working correctly.
How do I get AI product recommendations using natural language? +
The search_recs tool allows your agent to fetch product recommendations based on specific ML logics, such as visual similarity or trending items. Simply ask your agent to show recommendations for a specific context or logic path.
Can I see which products are currently trending across my whole store? +
Absolutely. Use the search_trending tool to retrieve a baseline query sorted by relevance and sales velocity. Your agent will return the most popular items across your entire catalog, helping you monitor seasonal trends in real-time.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
WooCommerce
Manage products, orders, and store analytics on WooCommerce — the most customizable open-source eCommerce platform.
Printify
Automate your print-on-demand business — manage shops, create products, and track orders directly from any AI agent.
Treinta App
Empower Latin American SMBs automating Treinta app. Access ledgers, manage client debt, and review store inventories actively from chat.
You might also like
DocuSeal
Automate document signing workflows via DocuSeal — manage templates, send signature requests, and track signers directly from any AI agent.
ContextQA
Automate testing via ContextQA — manage test suites, track AI-healing executions, trigger automated runs, and audit API tests directly from any AI agent.
Node-RED
Manage Node-RED flows, nodes, and system diagnostics directly from your AI agent.