Skip to main content

At a glance

Credentials

Set these per environment. See Connect an integration.
VariableRequiredDescription
ALGOLIA_API_KEYYesAlgolia API key (use the Search API key for read-only access, or a scoped key with addObject for writes) Docs.
ALGOLIA_APP_IDYesAlgolia application ID (10-character uppercase ID shown next to your API keys) Docs.

Setup

  1. Create an Algolia application: Sign up at https://dashboard.algolia.com (the free Build plan works for testing) and create or select an application.
  2. Copy your credentials: In Settings → API Keys (https://dashboard.algolia.com/account/api-keys/all), copy the Application ID into ALGOLIA_APP_ID and an API key into ALGOLIA_API_KEY. Use the Search API key for read-only use, or create a scoped key with search, browse, and addObject ACLs for writes - avoid the Admin API key.
  3. Note your host: Tools take a ‘host’ parameter: pass “<ALGOLIA_APP_ID>-dsn.algolia.net” (your application ID followed by -dsn.algolia.net).
  4. Verify access: Run the List Indices tool. A 403 usually means the API key lacks the required ACL or the host does not match your application ID.
  • Algolia authenticates with two headers: X-Algolia-API-Key and X-Algolia-Application-Id - both env vars are required
  • Browse requires an API key with the ‘browse’ ACL; Save Objects requires ‘addObject’
  • The Search API key is safe to expose in frontends, but scoped/write keys must stay server-side
Provider API reference: https://www.algolia.com/doc/rest-api/search/

Tools

ToolAccessDescription
List IndicesReadList the indices in the Algolia application
Search IndexReadRun a search query against an index
Browse IndexReadBrowse all records in an index with cursor-based pagination
Get ObjectReadRetrieve a single record from an index by objectID
Save ObjectsWriteAdd or update records in an index via a batch operation

Example prompts

  • Search my Algolia index for a query I provide and summarize the top hits.
  • List my Algolia indices with their record counts and last update times.