X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Amplitude MCP with Atomic Agent

Connect Atomic Agent to Amplitude MCP. List all cohorts created this month, create dashboard with retention and revenue charts, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Amplitude MCP logoAmplitude MCP
Dcr Oauth

Amplitude MCP is Amplitude's product analytics service for tracking user behavior and product metrics. Use it to centralize product data and manage charts, dashboards, cohorts, experiments, and taxonomy.

48 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Amplitude.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Amplitude account. See the Atomic Agent documentation for installation instructions.

Also integrate Amplitude MCP with

ChatGPTClaude CoworkHermes

How Atomic Agent connects to Amplitude

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Amplitude to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Amplitude. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Amplitude account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Amplitude MCP server, and what's possible with it?

The Amplitude MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Amplitude account. It provides structured and secure access so your agent can perform Amplitude operations on your behalf.

Use Amplitude from Atomic Agent

With your account connected, ask Atomic Agent to work with Amplitude in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Amplitude MCP action and event your agent gets out of the box.

Create group types

Create one or more group types in a project, OR add already-ingested group types with status "unexpected" to the tracking plan.

Create properties

Create one or more properties in a project's tracking plan.

Delete event properties

Delete one or more event properties in a project.

Delete user properties

Delete one or more user properties in a project.

Get agent results

Retrieve results from AI agents that have analyzed your dashboards or session replays.

Get amplitude agent analytics info

Single read entry point for Amplitude Agent Analytics (AI/LLM session investigation).

Get amplitude charts

Read saved Amplitude charts by ID, or look up the chart-type schema.

Get amplitude context

Unified entry point for Amplitude context.

Get amp session replay info

Unified entry point for session replay data: find replays and inspect what happened in them.

Get amp taxonomy

Read a project's tracking plan: the events it defines, the properties on them, what a branch changes relative to main, and who changed what when.

Get amp user data

Look up Amplitude users.

Get data warehouse destinations

List the Data Warehouse export destinations configured for a project.

Get from url

Retrieve objects from Amplitude URLs WHEN TO USE: - CRITICAL: Only use this tool for full Amplitude app URLs on supported hosts (app.

Get group types

List available group types for a project.

Get session replay duration

APP SUPPORT ONLY.

Get session replay stream

APP SUPPORT ONLY.

Get session replay timeline

APP SUPPORT ONLY.

Get tracking plan sources

List the sources configured on a project's tracking plan (e.

Get transformations

Retrieve data transformations from a project.

Manage amp context

Manage AI context.

Manage amp entities

Create a shared (team) space, rename a space or change its members, or move charts, dashboards, notebooks, or cohorts into a shared space.

Manage amp events

Write to a project's tracking-plan events — raw ingested events, custom events, and labeled (autotrack) events — in one tool selected by `action` + `kind`.

Manage amp taxonomy

Read Data workspace governance settings and manage tracking-plan branches for a project.

Query amplitude data

Run analytics queries to answer data questions about users, events, funnels, and retention — and to create or modify charts via the typed `chart` parameter.

Rename chart

Rename a chart that has already been saved WHEN TO USE: - A chart was saved (e.

Render amplitude chart

Render an interactive Amplitude chart UI for a saved chart or a chart edit by ID.

Render amp session replay

Render an interactive session replay player UI for one or more session replays.

Restore event properties

Restore event properties that were previously marked as deleted in a project.

Restore user properties

Restore user properties that were previously marked as deleted in a project.

Save chart edits

Promote chart edits to saved charts — Save as (new chartId) or Save in place (same chartId).

Search amp data taxonomy

Semantic search over a project's data taxonomy: discover events, properties, and property values by describing what you're looking for in natural language.

Search amp entities

Search for dashboards, charts, notebooks, experiments, docs, and other content in Amplitude.

Share amp entities

Manage sharing and org invites for Amplitude entities.

Track ui render response

Internal telemetry tool used by MCP UI components to report render latency and errors.

Update properties

Update property description, isOfficial, category, and/or name in a project's tracking plan.

Use amp ai visibility

Use Amplitude AI Visibility.

Use amp comments

Read and add plain-text comments on Amplitude charts, dashboards, and notebooks.

Use amp dashboards

Read and manage Amplitude dashboards.

Use amp experiments

Unified entry point for experiments: read, analyze, create, and set metrics.

Use amp flags

Unified entry point for feature flags and deployments.

Use amp guides surveys

List Guides and Surveys or get one by ID.

Use amplitude ai feedback

Read Amplitude AI Feedback (customer VoC) for a project — surveys, support tickets, app reviews, and grouped themes.

Use amplitude chart monitors

Read and manage chart alert monitors.

Use amplitude cohorts

Work with Amplitude cohorts end to end.

Use amplitude data connections

Unified entry point for everything to do with a project's data connections — ingestion sources, import/export job history, Snowflake credentials, live Snowflake warehouse browsing, and Amplitude import-config recommendations.

Use amplitude metrics

Unified entry point for metric definitions, goals, and goal alerts in a project.

Use amp notebooks

Read and manage Amplitude notebooks.

Use amp skill

Load an Amplitude skill — a workflow playbook describing the optimal sequence of Amplitude tools for a task.

FRAMEWORKS

How to build Amplitude MCP Agent with another framework

ChatGPT logo

ChatGPT

Use Amplitude MCP with ChatGPT

Claude Cowork logo

Claude Cowork

Use Amplitude MCP with Claude Cowork

Hermes logo

Hermes

Use Amplitude MCP with Hermes

FAQ

Frequently asked questions

With a standalone Amplitude MCP server, the agents and LLMs can only access a fixed set of Amplitude tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Amplitude and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Amplitude tools.

Yes, absolutely. You can configure which Amplitude scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Amplitude data and credentials are handled as safely as possible.

Start with Amplitude MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Amplitude MCP tool your agent needs.Free to start.

Start building