> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Amplitude

> Connect Amplitude to your Atako agents — 14 read and 0 write actions.

Let your agents read your Amplitude product analytics — event lists, segmentation, funnels, retention, active users, sessions, user activity, cohorts, and taxonomy.

## Connection

* **Authentication**: API key (API Key:Secret Key).
* **Required settings**:
  * **Host** — Use amplitude.com for US projects, or analytics.eu.amplitude.com for EU-hosted projects.

<Note>
  Amplitude → Settings → Projects → General → API Key and Secret Key. Copy both values. Enter them as api\_key:secret\_key (joined by a colon). The key requires at minimum "Read" access to the project.

  See [Amplitude's documentation](https://amplitude.com/docs/apis/analytics/dashboard-rest).
</Note>

## Read actions (14)

| Action                      | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `active_users`              | Get the number of active or new users over a date range. Dates are YYYYMMDD.                                                                                                                                                                                                                                                                                                                                                                                      |
| `event_segmentation`        | Get metrics (uniques, totals, pct\_dau, average, histogram, sums, value\_avg) for one or two events over a date range. Event parameter e is a JSON object: \{"event\_type":"...", "filters":\[\{"subprop\_type":"event","subprop\_key":"...","subprop\_op":"is","subprop\_value":\["..."]}],"group\_by":\[\{"type":"event","value":"..."}]}. Dates are YYYYMMDD. Segment s and group\_by g are also JSON-encoded.                                                 |
| `funnel_analysis`           | Get funnel conversion data for an ordered series of events (2 or more steps) over a date range. e is an array of step objects, same format as event\_segmentation's e: \[\{"event\_type":"..."},\{"event\_type":"...","filters":\[...]}] — each step is sent as its own e= query parameter. Dates are YYYYMMDD. mode: ordered (default), unordered or sequential; n: active (default) or new users; cs: conversion window in seconds (default 2592000 = 30 days). |
| `list_cohorts`              | List all discoverable cohorts in the project. Returns cohort id, name, description, size, owners, and sync metadata.                                                                                                                                                                                                                                                                                                                                              |
| `list_events`               | List all event types in the project with their current week totals, uniques, and % DAU. Returns event names, whether they are hidden/deleted, and display names. No arguments required.                                                                                                                                                                                                                                                                           |
| `realtime_active_users`     | Get the real-time active user count. Only accepts interval i = -300000 (real-time, last 5 minutes).                                                                                                                                                                                                                                                                                                                                                               |
| `retention_analysis`        | Get user retention for a start event (se) and return event (re). Both are JSON objects with event\_type. se supports "\_new" (new users) or "\_active" (all users). re supports "\_all" (all events) or "\_active" (all active events). Dates are YYYYMMDD.                                                                                                                                                                                                       |
| `revenue_ltv`               | Get revenue lifetime value metrics over a date range. Dates are YYYYMMDD.                                                                                                                                                                                                                                                                                                                                                                                         |
| `sessions_average_length`   | Get the average session length in seconds per day over a date range. Dates are YYYYMMDD.                                                                                                                                                                                                                                                                                                                                                                          |
| `taxonomy_event_properties` | List event properties for a specific event type. The event\_type parameter filters properties to those attached to the given event.                                                                                                                                                                                                                                                                                                                               |
| `taxonomy_events`           | List all event types in the project. Hidden events are excluded. Pass showDeleted=true as a query param to include deleted events.                                                                                                                                                                                                                                                                                                                                |
| `taxonomy_user_properties`  | List all user properties in the project. Hidden properties are excluded.                                                                                                                                                                                                                                                                                                                                                                                          |
| `user_activity`             | Get a user summary and their most or least recent events. The user parameter is the Amplitude ID (numeric). Returns userData (profile stats) and events array.                                                                                                                                                                                                                                                                                                    |
| `user_search`               | Search for a user by user\_id, amplitude\_id, device\_id, or email address. Returns user summaries matching the query.                                                                                                                                                                                                                                                                                                                                            |

## Write actions (0)

This connector is read-only — it exposes no write actions.

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.