At a glance
- Availability: Experimental (how to enable).
- Auth: API key.
- Connection: The key from
ALGOLIA_API_KEYis sent as theX-Algolia-API-Keyheader. - Docs: https://www.algolia.com/doc/rest-api/search/
Credentials
Set these per environment. See Connect an integration.Setup
- Create an Algolia application: Sign up at https://dashboard.algolia.com (the free Build plan works for testing) and create or select an application.
- 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.
- Note your host: Tools take a ‘host’ parameter: pass “<ALGOLIA_APP_ID>-dsn.algolia.net” (your application ID followed by -dsn.algolia.net).
- 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
Tools
| Tool | Access | Description |
|---|---|---|
| List Indices | Read | List the indices in the Algolia application |
| Search Index | Read | Run a search query against an index |
| Browse Index | Read | Browse all records in an index with cursor-based pagination |
| Get Object | Read | Retrieve a single record from an index by objectID |
| Save Objects | Write | Add 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.