MCP Tools

The tools the SearchX MCP server exposes to a connected assistant. The model calls them automatically, so you never invoke them by hand.

search_products

Full-text search over the merchant's catalog.

• query (required): the shopper's search text, e.g. "running shoes with good cushioning".
• limit (optional): max products to return (default 10).
• filter (optional): a catalog filter expression, e.g. price < 120 or color = 'navy'.

Returns a list of products (title, price, url, brand, color, image).

search_by_intent

Semantic search by meaning rather than exact keywords. Best when the shopper describes a need, occasion, or vibe, such as "something warm for hiking in the rain", "a gift for a 5-year-old who loves dinosaurs".

• query (required): the shopper's intent in natural language.
• limit (optional): max products to return (default 10).
• filter (optional): catalog filter expression.

Returns matching products in the same shape as search_products.

get_product_details

Fetch the full details of a single product.

• id (required): the product id, as returned in the id field of a search result.

Returns one product, or a not-found message.

find_alternatives

"More like this": products similar to a given one.

• productId (required): the id of the product to find alternatives for.
• limit (optional): max alternatives to return (default 10).

Returns a list of similar products.

compare_products

Fetch several products and return a side-by-side comparison.

• ids (required): 2 to 5 product ids to compare.

Returns each product plus a per-field comparison (title, price, brand, color) noting where they differ.

ask_about_searchx

Answers questions about the SearchX product itself: what it is, the company, features, pricing, and how to integrate it. Use this for product questions, not catalog search.

• question (required): the user's question about SearchX.
• topic (optional): about, docs, faq, or all (default).