KosmoKrator

analytics

Amplitude Analytics MCP Integration for Claude Agent SDK

Connect Amplitude Analytics to Claude Agent 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 Claude Agent SDK

Give Claude Agent SDK workflows access to KosmoKrator integrations through a local MCP server.

Add a KosmoKrator stdio MCP server to the Claude Agent SDK options. The gateway is local, scoped to this integration, and starts with --write=deny so Claude Agent SDK can inspect read-capable tools without receiving write access by default.

Amplitude Analytics MCP Config for Claude Agent SDK

Use a narrow integration list so the agent does not load unrelated tools.

{
  "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 Claude Agent SDK

Claude Agent SDK 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 Claude Agent SDKClient-level gateway setup.