KosmoKrator

search

Algolia MCP Integration for OpenAI Agents SDK

Connect Algolia to OpenAI Agents SDK through the local KosmoKrator MCP gateway with scoped tools, credentials, and write policy.

10 functions 5 read 5 write API key auth
Submit Algolia feedback View package source

Connect Algolia to OpenAI Agents SDK

Attach KosmoKrator integration tools to OpenAI Agents SDK workflows through a local MCP gateway.

Start the KosmoKrator MCP gateway locally and point the OpenAI Agents SDK MCP tool at that process or wrapper. The gateway is local, scoped to this integration, and starts with --write=deny so OpenAI Agents can inspect read-capable tools without receiving write access by default.

Algolia MCP Config for OpenAI Agents SDK

Use headless JSON commands for CI-style execution and MCP for agent tool discovery.

{
  "mcpServers": {
    "kosmokrator-algolia": {
      "type": "stdio",
      "command": "kosmo",
      "args": [
        "mcp:serve",
        "--integration=algolia",
        "--write=deny"
      ]
    }
  }
}

Run the Gateway Manually

kosmokrator mcp:serve --integration=algolia --write=deny

Why Use KosmoKrator Here

Scoped tools

Expose only Algolia instead of a broad multi-service tool list.

Local credentials

Reuse credentials already configured for the KosmoKrator CLI and Lua runtime.

Write policy

Start read-only, then opt into ask or allow for trusted workspaces.

Algolia Tools Visible to OpenAI Agents

OpenAI Agents sees stable MCP tool names generated from the Algolia integration catalog.

MCP toolSource functionTypeDescription
integration__algolia__algolia_search algolia.algolia_search Read Search an Algolia index. Supports full-text search with filters, faceting, and pagination. Use this to find records matching a query string or filter criteria.
integration__algolia__algolia_get_object algolia.algolia_get_object Read Retrieve a single record from an Algolia index by its objectID. Returns all attributes of the object.
integration__algolia__algolia_save_object algolia.algolia_save_object Write Create or replace a record in an Algolia index. The object is identified by its objectID. If a record with this objectID exists, it will be fully replaced.
integration__algolia__algolia_delete_object algolia.algolia_delete_object Write Delete a record from an Algolia index by its objectID. This action is irreversible.
integration__algolia__algolia_partial_update algolia.algolia_partial_update Write Update specific attributes of a record without replacing the entire object. Only the specified attributes will be changed; all other attributes remain unchanged.
integration__algolia__algolia_list_indices algolia.algolia_list_indices Read List all indices in the Algolia application. Returns index names, entry counts, and sizes information.
integration__algolia__algolia_get_settings algolia.algolia_get_settings Read Get the configuration settings of an Algolia index, including searchable attributes, ranking, facets, and more.
integration__algolia__algolia_clear_index algolia.algolia_clear_index Write Remove all records from an Algolia index. The index itself is preserved with its settings. This action is irreversible.
integration__algolia__algolia_batch algolia.algolia_batch Write Perform multiple write operations (addObject, updateObject, partialUpdateObject, deleteObject) in a single batch request for better performance.
integration__algolia__algolia_get_current_user algolia.algolia_get_current_user Read List API keys for the Algolia application. Use this to verify that authentication is working and to see which API keys exist.

Related Algolia Pages

Algolia CLIUse direct JSON commands instead of MCP discovery. Algolia MCPFull gateway reference and MCP tool names. KosmoKrator for OpenAI AgentsClient-level gateway setup.