Connect Amplitude to AI agents

Connect Amplitude to Claude, Codex, Cursor, or other AI agents for your entire team. Metorial security, governance, observability, and gives your team a unified Magic MCP url to connect.

Supported Tools

track_events

Track Events

Send one or more events to Amplitude for analytics tracking with user properties, event properties, revenue data, and selected device metadata. Use the batch mode for high-volume ingestion (>1000 events/second).

get_chart_results

Get Chart Results

Download results from a saved Amplitude chart by its chart ID. The chart ID is in the chart URL. Returns a downloadable file; it does not render or edit the chart.

manage_annotations

Manage Annotations

Manage chart annotations in Amplitude. Annotations mark important events on time-series charts (e.g., releases, campaigns, milestones). List, create, update, or delete annotations.

manage_cohorts

Manage Cohorts

List, retrieve, create, or update behavioral cohorts in Amplitude. Cohorts are groups of users defined by shared behavior or characteristics. Use this to list all cohorts, get details of a specific cohort, or upload/update a cohort with specific user IDs.

get_user_profile

Get User Profile

Retrieve an Amplitude user profile including user properties, computed properties, and synced cohort memberships. Look up by user ID or resolve an Amplitude ID to the user's profile.

query_event_segmentation

Query Event Segmentation

Analyze event data with segmentation, filtering, and grouping. Returns time-series or aggregate data for specific events, similar to Amplitude's Event Segmentation chart. Supports metrics like event totals, uniques, DAU, session averages, property sums/averages, and more.

query_user_composition

Query User Composition

Analyze the distribution of a user property across your active users. Returns how many users have each value of the specified property (e.g., country breakdown, platform split, plan type distribution).

query_sessions

Query Sessions

Retrieve session metrics including session length distribution, average duration in seconds, and average sessions per user over a date range. Useful for understanding user engagement depth and session patterns.

delete_user_data

Delete User Data

Request deletion of user data from Amplitude for privacy compliance (GDPR/CCPA). Supports deleting a single user or multiple users in bulk. You can also check the status of pending deletion jobs.

query_active_users

Query Active Users

Retrieve daily, weekly, or monthly active and new user counts for the project already selected by the API-key connection. Call this tool directly with dates; no project ID, event discovery, or OAuth context lookup is needed. Returns time-series data showing how many users were active (performed any event) or new during each interval. Supports segmentation and grouping by user properties. Requires the API Key + Secret Key connection, not OAuth.

manage_taxonomy

Manage Taxonomy

Manage your Amplitude tracking plan (taxonomy). Create, update, delete, and list event types, event properties, user properties, and event categories. Useful for programmatically maintaining a clean, well-documented tracking plan.

identify_user

Identify User

Set or update user properties for a specific user without sending an event. Supports Amplitude's property operations like $set, $setOnce, $add, $append, $prepend, $unset, and $clearAll. Can also be used for group identification and user identity mapping (aliasing).

query_funnel

Query Funnel

Analyze conversion funnels to understand how users progress through a sequence of events. Returns step-by-step conversion rates and drop-off data. Supports "this order" (strict sequence) and "any order" modes, plus segmentation and grouping.

query_retention

Query Retention

Analyze user retention to understand how well users are retained over time after performing a starting event. Measures how many users come back to perform a return event on subsequent days/weeks/months.

export_events

Export Events

Export Amplitude raw event files for an uploaded-time range as a downloadable ZIP file. Use this for archival, warehouse backfills, or offline inspection of raw JSON event exports.

create_notebook_report

Create Notebook Report

Create a downloadable HTML notebook with ordered narrative sections from 1–10 saved Amplitude charts using OAuth. Discover projects with get_amplitude_context and charts with get_amplitude_charts. Queries event segmentation, sessions, funnels, and retention results; preserves source links, provider values, metric semantics, and incomplete/truncated result warnings. Plain text is escaped. Files are limited to 4 MiB. This read-only export does not create or edit a native Amplitude notebook.

get_flags

Get Amplitude Flags

List feature flags or read one by ID. OAuth requires a project ID from get_amplitude_context. API Key + Secret Key connections require an additional Experiment management API key; projectId is optional there and filters a list or verifies a single flag belongs to that project. Returns configuration, not experiment statistical results.

search

Search Amplitude

Search charts, raw events, event/user properties, or flags using OAuth and a project ID from get_amplitude_context. Project API keys support events, event/user/group properties, and cohorts; flags and experiments additionally require an Experiment management API key. Charts/events/properties use provider search with OAuth. Flags and experiments match names, IDs, keys, display names, or descriptions locally within one upstream page: continue even after an empty page when pagination.has_more is true. Project-key taxonomy/cohort complete lists use local matching with a 10,000-record cap. Does not search dashboards, notebooks, or documentation.

get_properties

Get Amplitude Properties

List, search, or retrieve event and user property metadata with OAuth or project API keys. Group properties require project API keys; omit groupType for shared group properties. With OAuth, discover project IDs using get_amplitude_context. Event properties require an exact eventType from manage_amp_events. A name lookup returns one property in the same list-shaped output. Project-key complete lists are searched locally, with a 10,000-record cap and pagination.

query_amplitude_data

Query Amplitude Data

Compute analytics results for an existing saved chart using Amplitude OAuth. Discover project and chart IDs with get_amplitude_context and get_amplitude_charts. Supports event segmentation, sessions, funnels, and retention, with optional result-size overrides. Documented date overrides currently fail upstream for a tested saved segmentation chart; see timeRange. This read-only query does not create chart edits or save changes; it does not accept arbitrary new chart definitions.

query_experiment

Query Experiment

Reconstruct a descriptive control-versus-treatment conversion comparison from explicit exposure and outcome events. Runs two independent ordered funnels filtered by exact flag and variant event properties, and returns whole-range unique counts, conversion rates, and lift. Requires the Analytics API key and secret; no Experiment management key is needed.

get_experiments

Get Amplitude Experiments

List experiments and their configuration, or retrieve one by ID. Requires an Experiment management API key on the API Key + Secret Key connection; OAuth and project keys alone do not authorize this endpoint. This returns experiment configuration, not statistical analysis or variant performance results.

manage_amp_events

Read Amplitude Events

Read or search raw event definitions using OAuth or project API keys. With OAuth, call get_amplitude_context for project IDs. Project keys read their connected project taxonomy and can add visible-event usage metadata, including this week's event totals. Taxonomy lists omit hidden and deleted events. Only reads are supported. The event ID is its exact event_type name.

get_amplitude_context

Get Amplitude Context

Discover your authenticated user, organization, and accessible projects using Amplitude OAuth. Projects are paginated; reuse the returned pagination cursor. Optional projectId also returns matching accessible project metadata, scanning up to 50 project pages independently of list search filters. Project API-key REST tools already identify their project and do not require this discovery step.

get_amplitude_charts

Get Amplitude Charts

List or search saved charts in an OAuth-accessible project, or retrieve one chart by ID. Call get_amplitude_context for projects. A chart read can include its read-only raw definition; definitions are not an authoring API. For chart results use query_amplitude_data. Search pages stop at 10,000 matches, so narrow large lists by name or type.

get_deployments

Get Amplitude Deployments

List deployments shared by Amplitude flags and experiments. Requires an Experiment management API key on the API Key + Secret Key connection. Optional projectId filters only the fetched page locally; follow nextCursor even if no deployments match this page. Returns identifiers and deployment configuration.

create_dashboard_report

Create Dashboard Report

Create a downloadable HTML dashboard with chart cards from 1–10 saved Amplitude charts using OAuth. Discover projects with get_amplitude_context and charts with get_amplitude_charts. Queries event segmentation, sessions, funnels, and retention results; preserves source links, provider values, metric semantics, and incomplete/truncated result warnings. Plain text is escaped. Files are limited to 4 MiB. This read-only export does not create or edit a native Amplitude dashboard.

get_user_activity

Get User Activity

Read a user summary and ordered event history using an Amplitude ID from search_users. Choose latest or earliest events and follow nextOffset until an empty page. Requires project API key and secret.

list_session_replays

List Session Replays

Discover session replay IDs and metadata in the connected project, optionally by time or an Amplitude ID from search_users. Use export_session_replay to download recording chunks. Requires project API key and secret.

export_cohort_members

Export Cohort Members

Start a downloadable cohort membership export with a cohortId from manage_cohorts, or resume an existing export with requestId. Polls for up to 20 seconds; pending responses retain the requestId for a later call without creating another export. Requires project API key and secret.

query_realtime_users

Query Real-time Users

Retrieve today and yesterday active-user time series in five-minute buckets, preserving provider labels and missing values. Call directly with an empty object using the project API key and secret. These are bucketed active users, not currently connected or concurrent users.

search_users

Search Users

Find users by user ID, device ID, Amplitude ID, or user ID prefix and return Amplitude IDs for activity and replay lookup. Empty matches are normal. Uses the connected project API key and secret; no project ID is needed.

check_chart_threshold

Check Chart Threshold

Run one saved Amplitude chart query with OAuth and compare one explicitly selected numeric point against a threshold. Always requests incomplete-point exclusion. Discover projects/charts with get_amplitude_context/get_amplitude_charts and select an exact series ID and zero-based point index from query_amplitude_data with excludeIncompleteDatapoints=true and matching query options. Uses the returned point without summing or deriving metrics. Empty/null/absent selections return no_data; truncated, incomplete, unsupported, or unconfirmed-completeness results return inconclusive with matched=null. This is an on-demand read, without scheduling or notifications.

query_revenue_ltv

Query Revenue Lifetime Value

Query observed revenue lifetime value by new-user acquisition cohort: ARPU, ARPPU, total revenue, or paying users. Preserves cohort dates, rNd day-since-acquisition values, count, paid, total_amount, and nulls. Requires project API key and secret; no project ID or OAuth discovery is needed.

export_session_replay

Export Session Replay

Download one ordered page of gzip-compressed version 3 rrweb JSON chunks and a JSON manifest for a replay discovered with list_session_replays. Follow nextCursor until hasMore is false to collect a full recording. Requires project API key and secret.

More integrations teams use with Amplitude

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Subscribe to real-time change events via Change Data Capture and Platform Events. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Apolloio

Search and prospect B2B contacts and companies from a database of over 275 million people and 70 million organizations. Enrich people and company data with emails, phone numbers, and firmographic details. Create and manage contacts, accounts, deals, and tasks. Add contacts to email sequences and manage sequence statuses. Log and search call records. Perform bulk operations for contact creation, account creation, task creation, and data enrichment.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Subscribe to webhooks for list and library change notifications. Retrieve site properties and search for sites across Microsoft 365.

Hubspot

Create, read, update, and delete CRM objects including contacts, companies, deals, tickets, and custom objects. Manage associations between CRM records. Track engagements such as calls, emails, meetings, notes, and tasks. Send transactional and marketing emails, manage campaigns, and handle subscription preferences. Build and manage marketing workflows, sequences, and automation actions. Manage CMS content including blog posts, landing pages, and HubDB tables. Handle commerce data including products, orders, invoices, quotes, and payments. Create and manage contact lists for segmentation. Configure deal, ticket, and order pipelines with custom stages. Search and filter CRM records. Bulk import and export CRM data. Manage users, teams, and account settings. Subscribe to webhooks for real-time notifications on object creation, deletion, property changes, merges, and association changes.

Airtable

Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.

Technical notes for Amplitude

Ingest events, query analytics, download exports, and manage cohorts, taxonomy, user properties, annotations, and privacy requests through Amplitude REST APIs. Discover projects, events, properties, flags, and experiments; compare exposure-to-conversion funnels; create downloadable dashboard and notebook reports; and check saved-chart thresholds on demand. OAuth enables saved-chart discovery and reports. Experiment management reads require a separate management API key. Search users, inspect event history, download session replay chunks and cohort members, and query acquisition-cohort revenue lifetime value and five-minute active users using project credentials.

Connect Amplitude to production AI agents

See how Metorial gives Amplitude access the governance, tracing, and security controls teams need.

Frequently asked questions

Common questions about connecting Amplitude to AI agents with Metorial.

  1. Can Metorial connect Amplitude to AI agents?
    Yes. Metorial connects AI agents to Amplitude through a governed integration layer, so teams can use the provider while keeping access controlled and observable.
  2. Metorial is MCP compatible and lets teams expose approved provider tools to MCP-capable agents and clients through a controlled access layer.
  3. Metorial applies policies across users, groups, providers, agents, and individual tools, then records the context around every agent interaction.
  4. Yes. Metorial records provider activity so teams can inspect tool calls, troubleshoot integrations, and give security teams the visibility they need.