Algolia Search MCP Server

Base URL: https://ALGOLIA_APPLICATION_ID.algolia.net

Install

Quick Start (recommended)

APP_ID_API_KEY=YOUR_APP_ID_API_KEY \
API_KEY=YOUR_API_KEY \
SERVER_APPID=YOUR_SERVER_APPID \
uvx mcparmory-algolia-search

With pip

pip install mcparmory-algolia-search
APP_ID_API_KEY=YOUR_APP_ID_API_KEY \
API_KEY=YOUR_API_KEY \
SERVER_APPID=YOUR_SERVER_APPID \
mcparmory-algolia-search

MCP Client Configuration

Add to your MCP client config (e.g. Claude Desktop, Cursor, Codex):

{
  "mcpServers": {
    "algolia-search": {
      "command": "uvx",
      "args": ["mcparmory-algolia-search"],
      "env": {
        "APP_ID_API_KEY": "YOUR_APP_ID_API_KEY",
        "API_KEY": "YOUR_API_KEY",
        "SERVER_APPID": "YOUR_SERVER_APPID"
      }
    }
  }
}

Credentials

Set the following environment variables (via MCP client env config, shell export, or .env file):

• APP_ID_API_KEY — API Key Authentication (x-algolia-application-id)
• API_KEY — API Key Authentication (x-algolia-api-key)
• SERVER_APPID — Server variable: appId (default: ALGOLIA_APPLICATION_ID)

Do not commit credentials to version control.

Run Locally

First, configure your credentials in .env (see Credentials above).

pip install -r requirements.txt
python server.py

Connect MCP Client

Edit .mcp.json and replace <SERVER_DIR> with the absolute path to this directory, then add to your MCP client configuration.

Example (if server is at /home/user/mcp-servers/algolia-search):

{
  "mcpServers": {
    "algolia-search": {
      "command": "python",
      "args": ["/home/user/mcp-servers/algolia-search/server.py"]
    }
  }
}

Docker

Pre-built image (recommended)

docker run -p 8000:8000 \
  -e APP_ID_API_KEY=YOUR_APP_ID_API_KEY \
  -e API_KEY=YOUR_API_KEY \
  -e SERVER_APPID=YOUR_SERVER_APPID \
  ghcr.io/mcparmory/algolia-search:latest

Build from source

First, configure your credentials in .env (see Credentials above).

docker build -t algolia-search .
docker run -p 8000:8000 --env-file .env algolia-search

Before running, make sure ports 8000 are free.### MCP client config (Docker)

For Docker, use SSE transport in your MCP client config:

{
  "mcpServers": {
    "algolia-search": {
      "type": "sse",
      "url": "http://localhost:8000/sse"
    }
  }
}

Files

• .env - Credentials and server configuration
• .mcp.json - MCP client config template
• Dockerfile - Container build
• LICENSE - MIT license for this generated code
• requirements.txt - Python dependencies
• README.md - This file
• server.py - MCP server entry point
• _auth.py - Authentication handlers
• _models.py - Request/response models
• _validators.py - Input validation

Note: Files starting with . are hidden by default on macOS/Linux. Use ls -a in terminal or enable "Show hidden files" in your file manager to see .env and .mcp.json.

_{Generated by MCP Blacksmith · Quickstart docs · Report a bug}