stackgate.ai
All integrations

Algolia

Connect Claude, ChatGPT or Cursor to Algolia via MCP. List indices, search records, browse objects, and review top searches with API key connect.

Manual setup 6 tools

Example questions

Try asking your AI client

  • What are people searching for most on the docs index this week?

  • Did the query MCP gateway start returning the right page?

  • Which searches have zero results that I should fix?

  • Write a short search-quality brief for Amalie - do not change the index.

  • Find records that mention private gateway in the help index.

Overview

Connect Algolia so AI clients can list search indices, query records, browse objects, and review top searches via the Algolia Search API.

This integration is read-first: no index settings changes or record writes.

Prerequisites

  • An Algolia account with at least one index
  • An API key with read/search ACLs (search-only key recommended)
  • Your Algolia Application ID
  • A stackgate.ai account

Getting credentials

  1. Sign in to the Algolia dashboard.
  2. Open Settings → API Keys.
  3. Copy your Application ID.
  4. Create or copy a Search-Only API Key (or a custom key limited to search, browse, settings, and analytics as needed).
  5. In stackgate.ai, open My Integrations → Algolia.
  6. Paste the Application ID and API key, then save.
  7. Optionally restrict allowed indices in credentials to limit which index names tools can access.

See the Algolia API keys guide.

Key types and security

Key type Recommended use Notes
Search-Only Production AI read access Cannot modify indices or records
Admin Avoid for AI clients Full write access to indices and settings
Custom ACL Fine-grained control Limit to specific indices and search, browse, settings, analytics

Indexed records may contain personal data. Use least-privilege keys and review what your indices store.

Using with AI clients

  • Dedicated endpoint: POST /mcp/algolia with a Sanctum bearer token
  • Private gateway: use algolia__* namespaced tools

Example prompts:

  • "List my Algolia indices."
  • "Search the products index for running shoes under 500 DKK."
  • "Show top searches on the products index for the last 7 days."

Troubleshooting

  • 422 integration not configured — complete the Application ID and API key form in My Integrations.
  • 401/403 from Algolia — regenerate the API key and confirm ACLs include the target index.
  • Index not allowed — update allowed indices in My Integrations or remove the restriction.
  • 429 Too many requests — Algolia enforces per-application rate limits; retry after a short delay.
  • Analytics tool fails — get_top_searches requires analytics ACL on the API key.

Revoking access

  1. Disconnect Algolia in My Integrations on stackgate.ai.
  2. Delete or rotate the API key in the Algolia dashboard.

Available tools

  • list_indices

    List Algolia indices in the connected application with entry counts and last build times.

  • get_index_settings

    Get Algolia index settings (searchable attributes, ranking, replicas, and facets).

  • search_records

    Search records in an Algolia index with a query and optional filter expression.

  • get_object

    Get a single Algolia record by object ID.

  • browse_index

    Browse all records in an Algolia index with cursor-based pagination.

  • get_top_searches

    Get top search queries for an Algolia index from the Analytics API (requires analytics ACL on the API key).

MCP endpoint: https://stackgate.ai/mcp/algolia (HTTP) or via the private gateway.

Create account Documentation