KosmoKrator

analytics

Amplitude Analytics MCP Integration for OpenAI Agents SDK

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

7 functions 7 read 0 write API key auth
Submit Amplitude Analytics feedback View package source

Connect Amplitude Analytics 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.

Amplitude Analytics MCP Config for OpenAI Agents SDK

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

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

Run the Gateway Manually

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

Why Use KosmoKrator Here

Scoped tools

Expose only Amplitude Analytics 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.

Amplitude Analytics Tools Visible to OpenAI Agents

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

MCP toolSource functionTypeDescription
integration__amplitude__amplitude_list_events amplitude.amplitude_list_events Read List events from Amplitude Analytics. Optionally filter by user ID, device ID, or time range. Returns the most recent events matching the criteria.
integration__amplitude__amplitude_get_event amplitude.amplitude_get_event Read Retrieve a single Amplitude event by its ID. Returns full event details including all event properties and metadata.
integration__amplitude__amplitude_list_funnels amplitude.amplitude_list_funnels Read List funnels configured in Amplitude. Optionally filter by project ID. Returns funnel names, IDs, and summary conversion metrics.
integration__amplitude__amplitude_get_funnel amplitude.amplitude_get_funnel Read Retrieve a single Amplitude funnel by its ID. Returns the full funnel definition including steps, conversion rates, and drop-off metrics.
integration__amplitude__amplitude_list_cohorts amplitude.amplitude_list_cohorts Read List behavioral cohorts in Amplitude. Optionally filter by project ID. Returns cohort names, IDs, and membership counts.
integration__amplitude__amplitude_get_cohort amplitude.amplitude_get_cohort Read Retrieve a single Amplitude cohort by its ID. Returns the full cohort definition including behavioral criteria and membership size.
integration__amplitude__amplitude_get_current_user amplitude.amplitude_get_current_user Read Get the currently authenticated Amplitude user. Returns account details for the API key owner — useful for verifying credentials and checking permissions.

Related Amplitude Analytics Pages

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