Algolia MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Algolia MCP or direct API to search indexes, add or update records, delete entries, and analyze search performance through natural language.

Algolia logoAlgolia
Api Key

Algolia is a hosted search API that powers lightning-fast, relevant search experiences for web and mobile apps. It helps developers deliver instant, typo-tolerant, and scalable search without complex infrastructure.

127 Tools

Try Algolia now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Algolia
Try asking
TOOLS

Supported Tools

Every Algolia action and event your agent gets out of the box.

Add AB Test

Tool to create an A/B test comparing search performance between two index variants.

Add or Replace Record

Tool to add or replace a specific record in an index by objectID.

Add Record to Index

Tool to add a record to an index with auto-generated objectID.

Browse Algolia Index

Browse a batch of records in an Algolia index, optionally filtering them by query or browse parameters.

Clear Objects

Tool to clear records of an index without affecting settings.

Clear Rules

Clear all rules from an Algolia index, optionally forwarding the operation to replica indices.

Clear Synonyms

Clear all synonyms from an Algolia index, optionally forwarding the operation to replica indices.

Clicked Object IDs

Tool to send a click event to Algolia to capture clicked items.

Clicked Object IDs After Search

Tool to send a click event after a search response.

Converted Object IDs

Tool to send a conversion event for items outside of search context.

Copy Index

Initiate an index copy and return an asynchronous task ID.

Create API Key

Tool to create a new API key with specific permissions and restrictions.

Create Authentication

Create an authentication resource in the US region of Algolia's ingestion API for connecting to sources or destinations.

Create Destination

Create a destination for data ingestion using the US Algolia Ingestion API endpoint.

Create Ingestion Task

Create an ingestion task connecting a source to a destination for data synchronization with an Algolia index.

Create or Update Recommend Rules

Tool to create or update a batch of Recommend Rules in an index.

Create Query Suggestions Config

Tool to create a new Query Suggestions configuration for an Algolia index.

Create Source

Tool to create a new data source in Algolia Ingestion API.

Create Transformation

Tool to create a new transformation in Algolia Ingestion API.

Delete AB Test

Tool to delete an A/B test by its unique identifier.

Delete API Key

Delete an Algolia API key to revoke access.

Delete Authentication

Delete an Algolia ingestion authentication resource by ID in the US region.

Delete Query Suggestions Config

Tool to delete a Query Suggestions configuration for the specified index.

Delete Destination

Delete a destination by ID using the US Algolia Ingestion API endpoint.

Delete Index

Tool to delete the specified index and all its records.

Delete Multiple Records

Tool to delete multiple records from an Algolia index.

Delete Recommend Rule

Tool to delete a Recommend rule from a recommendation scenario.

Delete Records by Filter

Tool to delete records matching a filter from an Algolia index.

Delete Rule

Tool to delete the specified rule from an index.

Delete Source

Delete an Algolia Ingestion API source by ID.

Delete Synonym

Tool to delete a synonym from a specified index.

Delete Transformation

Tool to delete a transformation in Algolia Ingestion API.

Delete User Profile

Tool to delete a user profile from personalization.

Delete User Token

Delete events related to a user token from Algolia Insights event metrics and analytics using the US Insights endpoint.

Batch Operations on Multiple Indices

Tool to perform batch operations (add, update, delete) across multiple Algolia indices in a single request.

Export Rules

Export a page of rules from an Algolia index for backup or migration.

Find Object

Tool to find the first object matching a query or filter in an index.

Get A/B Test

Retrieve an A/B test by ID from the DE analytics region, including its status, performance metrics, and configuration details.

Get Add to Cart Rate

Tool to retrieve add-to-cart rate metrics for e-commerce search analytics.

Get API Key

Tool to retrieve the permissions and details of a specific API key.

Get App Task Status

Tool to check the status of an application task.

Get Authentication

Tool to retrieve an authentication resource by its ID.

Get Average Click Position

Tool to retrieve average click position metrics from Algolia Analytics.

Get Click Positions

Tool to retrieve the distribution of clicks by position from Algolia Analytics.

Get Click Through Rate

Tool to retrieve click-through rate (CTR) for searches with at least one click event.

Get Query Suggestions Config

Tool to retrieve a Query Suggestions configuration by index name.

Get Personalization Config

Retrieve the advanced personalization configuration from the EU endpoint, including personalization settings, re-ranking impact and profile type.

Get Conversion Rate

Retrieve conversion rate analytics for an index from the US analytics endpoint, including daily breakdowns.

Get Destination

Retrieve an Algolia ingestion destination by ID using the US endpoint.

Get Dictionary Languages

Tool to list available languages for dictionary entries.

Get Dictionary Settings

Tool to retrieve dictionary settings for all dictionaries.

Get Logs

Tool to retrieve log entries for API requests made to your Algolia application.

Get No Click Rate

Retrieve aggregate and daily no-click rates for tracked searches on an index, with optional date and tag filters.

Get No Results Rate

Retrieve aggregate and daily no-results rates for an index using the US analytics endpoint.

Get No Results Searches

Retrieve frequent searches that produced zero results for an index using the US analytics endpoint.

Get Object Position

Find an object’s zero-based position by objectID in the hits of a supplied search response.

Get multiple objects

Tool to retrieve multiple records from an index.

Get Purchase Rate

Retrieve purchase rate metrics for an index, including daily breakdowns, from the US analytics region.

Get Recommend Rule

Tool to retrieve a Recommend rule that was previously created in the Algolia dashboard.

Get Recommend Task Status

Tool to check the status of a Recommend task.

Get Record from Index

Tool to retrieve a specific record from an index by its objectID.

Get Revenue

Retrieve search-related revenue data from Algolia Analytics using the US regional endpoint.

Get Rule

Tool to retrieve a specific rule by its objectID from an index.

Get Searches Count

Retrieve search counts for an index over a time range, including a daily breakdown, using the US regional Analytics endpoint.

Get Searches No Clicks

Retrieve top searches without clicks from Algolia Analytics using the US regional endpoint, to help identify queries that may need optimization.

Get Index Settings

Retrieve selected settings for a specified Algolia index to inspect its configuration.

Get Source

Tool to retrieve a source from the Algolia Ingestion API.

Get Synonym

Tool to retrieve a specific synonym by its objectID.

Get Task Status

Tool to check the status of an asynchronous task.

Get Top Countries

Retrieve top countries by search volume for a specified index using the US analytics endpoint, to analyze the geographic distribution of searches.

Get Top Filter Attributes

Tool to retrieve top filter attributes from Algolia Analytics.

Get Top Filter For Attribute

Tool to retrieve top filter values for a specific attribute from Algolia Analytics.

Get Top Filters No Results

Tool to retrieve top filters for searches that returned no results from Algolia Analytics.

Get Top Hits

Tool to retrieve the object IDs of the most frequent search results from Algolia Analytics.

Get Top Searches

Retrieve popular search queries from Algolia Analytics, with optional click analytics and revenue metrics.

Get Transformation

Tool to retrieve a transformation by its ID from Algolia's Ingestion API.

Get Usage Statistics

Tool to retrieve Algolia usage statistics over a specified time period.

Get Usage for Index

Retrieve usage statistics for a specific Algolia index over a time period, with hourly or daily aggregation, including metrics such as record counts, query volumes, and processing times.

Get Users

Retrieve user profiles and affinities from Algolia advanced personalization using the EU endpoint.

Get Users Count

Retrieve the number of unique users for an index over a time range, including a daily breakdown, using the US Algolia Analytics endpoint.

Index Exists

Tool to check if an Algolia index exists.

Init Insights API Client

Return Insights client configuration for a selected region, including the application ID, API key, host, and cookie-setting metadata.

List AB Tests

List a page of A/B tests for the application in the DE analytics region, with optional index prefix or suffix filters.

List API Keys

List the application's main API keys with their permissions and restrictions for access-control review.

List Authentications

List a page of Algolia ingestion authentication resources in the US region, with optional type and platform filters.

List Destinations

List a page of Algolia ingestion destinations using the US endpoint, optionally filtering by type, authentication ID or transformation ID.

List Indices

Tool to list all indices and their metadata.

List Ingestion Tasks

List ingestion tasks using the US ingestion endpoint.

List Query Suggestions Configurations

Tool to retrieve all Query Suggestions configurations for an Algolia application.

List Task Runs

List Algolia Ingestion task runs using the US regional endpoint.

List Sources

Tool to list sources from the Algolia Ingestion API.

List Transformations

Tool to list all transformations in Algolia Ingestion API.

Partial Update Objects

Partially update multiple records in an index by objectID without replacing entire records.

Push Records to Task

Push records and a selected indexing action to a configured ingestion task by task ID, including actions to delete records, clear an index, or delete an index.

Replace All Rules

Batch save rules in an index, replacing existing rules by default.

Replace Task

Replace an Algolia Ingestion task with new configuration using the US regional API endpoint.

Restore API Key

Tool to restore a deleted API key within 72 hours of deletion.

Save Rule

Tool to create or replace a rule in an index.

Save Synonym

Tool to add or update a synonym in the specified index.

Save Synonyms

Batch create or replace synonyms in an Algolia index.

Search Authentications

Tool to search for authentication resources by IDs in Algolia.

Search Destinations

Search for multiple Algolia ingestion destinations by their IDs using the US endpoint.

Search Dictionary Entries

Tool to search dictionary entries in Algolia dictionaries.

Search Facet Values

Tool to search for values of a specified facet attribute.

Search Algolia Index

Tool to perform a search on a specified Algolia index.

Search Multiple Indices

Tool to perform searches across multiple indices in a single call.

Search Recommend Rules

Search Recommend rules in a specified index and model.

Search Sources

Search for multiple Algolia Ingestion API sources by their IDs using the US ingestion endpoint.

Search Synonyms

Search synonyms in a specified Algolia index, optionally matching a query or filtering by synonym type.

Search Transformations

Tool to search for transformations by IDs in Algolia Ingestion API.

Set Dictionary Settings

Tool to update dictionary settings for Algolia.

Set Personalization Strategy

Tool to define personalization strategy that controls how user behavior affects search results.

Set Index Settings

Tool to update an Algolia index's settings.

Stop AB Test

Tool to stop an A/B test by its unique identifier.

Try Transformation

Tool to try a transformation before creating it in Algolia.

Try Transformation Before Update

Tool to test a transformation before updating it in Algolia Ingestion API.

Update API Key

Tool to update the permissions and settings of an existing API key.

Update Authentication

Update the name or credentials of an Algolia ingestion authentication resource in the US region.

Update Query Suggestions Config

Tool to update an existing Query Suggestions configuration.

Update Destination

Update an Algolia ingestion destination using the US endpoint, including its configuration, name, type or associated transformations.

Update Dictionary Entries

Batch add or delete entries in an Algolia stopwords, plurals, or compounds dictionary.

Update Record Partially

Tool to add or update attributes in a single record.

Update Source

Tool to update a source in the Algolia Ingestion API.

Update Task

Partially update an Algolia Ingestion API task using the US ingestion endpoint.

Update Transformation

Tool to update an existing transformation in Algolia Ingestion API.

Validate Source

Tool to validate a source payload before creating it in Algolia.

Validate Source Before Update

Tool to validate a source update payload in the Algolia Ingestion API.

SETUP GUIDE

Connect Algolia MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["algolia"],
  mcp: true,
});
Create a session scoped to Algolia and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "Browse all records from the products index",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Algolia request
SETUP GUIDE

Connect Algolia API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["algolia"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Algolia
3

Run Algolia tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "Browse all records from the products index" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Algolia tool calls through the session, and print the final answer

Why Use Composio?

AI Native Algolia Integration

  • Supports both Algolia MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Algolia data

Managed Auth

  • Built-in API key handling with secure storage
  • Central place to manage, scope, and revoke Algolia access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Algolia
  • Scoped, least privilege access to Algolia resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Algolia.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Algolia tool your agent needs.Free to start.

Start building