MCP Reference

MCP Server Overview

Connect your SearchX catalog to AI assistants (Claude, ChatGPT, and any MCP-compatible client) so shoppers and agents can search your products in natural language.


What it is

The SearchX MCP server is a Model Context Protocol endpoint that exposes your product catalog to AI assistants as a set of tools. When a connected assistant needs to find, look up, or compare products, it calls these tools, and SearchX returns clean, ready-to-present results.

It is a thin layer over the SearchX API: no extra setup, no separate index. You take an application's API key from the dashboard, declare it in your assistant, and it works.

Endpoint: https://mcp.searchxengine.ai/mcp (remote, Streamable HTTP)


What your assistant can do

Once connected, the assistant calls these tools automatically based on the conversation:

ToolWhat it does
search_productsFull-text catalog search ("red running shoes under €120").
search_by_intentSemantic search by meaning ("something warm for hiking in the rain").
get_product_detailsFetch one product by its id.
find_alternatives"More like this": similar products to a given one.
compare_productsSide-by-side comparison of several products.
ask_about_searchxAnswers questions about SearchX itself (features, pricing, integration).

See the Tools page for the full reference. Results are stripped of internal fields before they reach the model, so the assistant only sees clean product data.


Try it

With the server connected, just ask naturally. The assistant decides when to call each tool, with no commands or special syntax:

  • "Find running shoes under €120."
  • "Show me something warm for hiking in the rain."
  • "What's similar to product ABC123?"
  • "What is SearchX and how much does it cost?"

Next steps

Authentication

Credentials, headers, and the security model.

Tools

The full tool reference: parameters and results.

Connecting Clients

Set up Claude, ChatGPT, LM Studio, and more.

Previous
Error Codes