MCP

What is MCP?

MCP is an experimental Model Context Protocol server that enables AI assistants to interact with Algolia APIs for search, indexing, analytics, and administration tasks. It is built for developers and AI enthusiasts who want to control Algolia directly from tools like Claude Desktop or Ollama.

How to use MCP?

Clone the repository, build the Go binary, then configure it as an MCP server in Claude Desktop by adding the binary path and Algolia credentials to the mcpServers JSON settings. Optionally set MCP_ENABLED_TOOLS to restrict which tools are available, or switch to SSE transport via MCP_SERVER_TYPE. You can also run MCP with the MCP Inspector for debugging or with Ollama using the mcphost CLI.

Key features of MCP

• Enables natural‑language interaction with Algolia APIs via MCP.
• Supports both stdio and SSE transport protocols.
• Includes tools for search, indexing, analytics, A/B testing, and recommendations.
• Allows selective tool activation through the MCP_ENABLED_TOOLS environment variable.
• Works with Claude Desktop, Ollama, and any MCP‑compatible client.

Use cases of MCP

• Search products in an Algolia index with filters like brand and price.
• Add, update, or delete records in an index via AI prompts.
• Modify index settings, such as searchable attributes or ranking rules.
• Run analytics or A/B testing experiments without a dedicated UI.
• Use local AI models (via Ollama) to manage Algolia data.

FAQ from MCP

What sort of things can I do once I install this MCP?

You can issue prompts like “Search all products where brand = ‘Nike’ and price < 100,” “Add this JSON object to the blog_posts index,” or “Update searchable attributes for the recipes index to include ingredients.”

Where can I read more about the Algolia MCP server?

Check out this blog post, which includes an embedded demo video.

How do I configure which tools are available?

Set the MCP_ENABLED_TOOLS environment variable to a comma‑separated list of tool names (e.g., "search,collections"). If empty or unset, all tools are enabled. Available tools include search, search_read, search_write, analytics, abtesting, collections, monitoring, querysuggestions, recommend, and usage.

What runtime and environment variables does MCP require?

You need Go to build the binary. The server requires ALGOLIA_APP_ID, ALGOLIA_INDEX_NAME, and ALGOLIA_API_KEY. For write operations, additionally set ALGOLIA_WRITE_API_KEY with an Admin API key.

Does MCP have any limitations or support guarantees?

This server is experimental, not officially supported by Algolia, and not covered by any SLA. It may be updated, broken, or removed at any time. Using it in production may affect your Algolia usage. Also, resource templates and root are not supported by Claude Desktop at this time.