Amplitude

Connect your AI agents to Amplitude.

Available Tools

get_active_users

Get active, new, returning, or exiting user counts over a date range. Dates must be in YYYYMMDD format. Supports dail…

get_average_session_length

Get average session length per day over a date range. Dates must be in YYYYMMDD format.

get_retention

Get user retention analysis for a starting and returning event over a date range. Pass event objects like “event_type…

get_funnel

Get funnel conversion analysis for a sequence of events over a date range. Pass a list of event objects like [“event_…

get_realtime_active_users

Get realtime active user counts with 5-minute granularity over the last 2 days. No date parameters needed.

get_revenue_ltv

Get lifetime value and revenue metrics for new users over a date range. Metrics include revenue, ARPU, ARPPU, and pay…

get_user_composition

Get user distribution across values of a specific property (e.g. country, platform, os) over a date range. Dates in Y…

list_annotations

List all chart annotations in the project. Returns annotation IDs, dates, labels, details, and category IDs.

get_annotation

Get a single annotation by ID. Use list_annotations to find valid IDs.

create_annotation

Create a chart annotation with a label and start timestamp (ISO 8601). Optionally assign a category name. Use list_an…

update_annotation

Update an existing annotation’s label, start/end timestamps, details, or category. Use list_annotations to find valid…

delete_annotation

Delete an annotation by ID. Use list_annotations to find valid IDs.

list_annotation_categories

List all annotation categories. Returns category IDs, names, and colors.

create_annotation_category

Create a new annotation category with a name and optional color.

delete_annotation_category

Delete an annotation category by ID. Use list_annotation_categories to find valid IDs.

get_chart_results

Get the results of a saved chart by its ID. Find chart IDs from the URL in Amplitude (e.g. the ID in https://app.ampl

list_cohorts

List all behavioral cohorts in the project. Returns cohort IDs, names, owners, size, and metadata. Use this to find c…

request_cohort_export

Request an async export of a cohort’s user data. Returns a request_id to poll status with. Use list_cohorts to find v…

update_cohort_membership

Add or remove user IDs from a cohort. Each membership item needs ‘ids’ (list of user IDs) and ‘operation’ (‘ADD’ or ’…

list_events

List all event types in the project with their weekly totals and percentage of DAU. Returns event names, totals, and …

get_event_segmentation

Get event segmentation data: counts, uniques, averages, or DAU percentage for a specific event over a date range. Sup…

list_event_types

List all event types in the project taxonomy with their display names, descriptions, categories, and visibility setti…

get_event_type

Get details for a specific event type by name, including its properties, description, and category. Use list_event_ty…

list_event_properties

List all properties for a specific event type. Returns property names, display names, types, and descriptions. Use li…

list_user_properties

List all user properties in the project taxonomy. Returns property names, display names, types, and descriptions.

search_users

Search for users by user ID or device ID. Returns matching users with their Amplitude ID, last seen time, country, pl…

get_user_activity

Get a user’s recent events and summary data by their Amplitude ID (numeric). Use search_users first to find the Ampli…

get_user_profile

Get a user’s profile including properties, cohort memberships, and recommendations from the Profile API. Provide eith…

validate_credential

Validate Amplitude API key and secret key by making a lightweight API call. Returns success status and a message.