Amplitude
Connect Amplitude to chart events, funnels, and retention, look up users and cohorts, and manage your event taxonomy. MCP setup for Claude and ChatGPT.
You paste two values for one Amplitude project: its API Key and a Secret Key, which Amplitude shows only when you generate it. Optional extra keys under More options add saved charts, Experiment and Enterprise organization tools.
- Setup time
- 5 min
- Auth
- API credentials
- API base URL
- https://amplitude.com (EU projects: https://analytics.eu.amplitude.com); ingestion, Experiment and the Developer API use their own hosts
- Rate limits
- Dashboard REST: up to 5 concurrent requests across all REST endpoints, a cost budget of 108,000 per hour and 1,000 per five minutes, and 360 queries an hour for User Activity and User Search; going over returns 429. Experiment Management API: 100 requests per second and 100,000 per day per project.
Before you begin
- The Manager or Admin role in Amplitude, because only Managers and Admins can see and generate API keys and secret keys
- The Amplitude project you want to connect. One PopMCP connection is one project.
- No region to look up: PopMCP detects US or EU data residency itself
- Optional extras only if you need them: Experiment for the Experiment keys, and an Enterprise plan for the SCIM and organization keys
Get your credentials
Open API Keys in Organization settings
In Amplitude, click Settings (the gear icon) and choose Organization settings, then select API Keys in the side navigation and pick the project you want to connect. Only Managers and Admins see this page.
API Keys
API keys and secret keys for each project in this organization.
| Name | Type | Created |
|---|---|---|
| Default3f9c****************************b21e | API Key | Jan 14, 2025 |
| Warehouse exportSecret value not shown | Secret Key | May 2, 2026 |
The same keys are also reachable from Projects, your project, General tab, with Manage next to API Key or Secret Key.
Copy the project's API Key
Copy the project's existing API key (32 characters), or click Generate API Key, name it PopMCP and copy the new one. The API Key identifies the project; on its own it can't read any data.
API Keys
API keys and secret keys for each project in this organization.
- API Key
- 3f9c4a7e2d1b8f60c5a9e7d3b4f2b21e
- Project ID
- 123456
Use the API Key and Secret Key of the same project. A pair from two projects is rejected.
Generate a Secret Key and copy it once
Click Generate Secret Key, name it PopMCP and copy it into a safe place straight away. Amplitude doesn't store secret keys, so this one can't be shown or retrieved again.
API Keys
API keys and secret keys for each project in this organization.
A project can have several secret keys, so creating one for PopMCP doesn't disturb keys your other tools use.
Optional: collect extra keys for the tools you need
Skip this for charts, funnels, retention, users, cohorts, export, taxonomy, annotations and ingestion, which the two project keys already cover. A Personal Access Token (your profile settings, Personal access tokens) adds saved charts (list_saved_charts, query_saved_chart), the project list, destinations, heatmaps and the newer taxonomy and flag endpoints, acting with your own permissions. An Experiment Management API key (in Experiment, Management API at the bottom left of the sidebar) adds flags, experiments, deployments, mutex and holdout groups, and lets evaluate_variants pick a deployment. An Experiment deployment key (Experiment, Deployments; starts server- or client-) only evaluates flags against that one deployment. A SCIM key (Enterprise: Organization settings, Access and SSO settings, Provisioning, Generate SCIM key) adds user and group provisioning. The Organization API key and Organization secret key (Enterprise, issued by Amplitude Support) add data access requests, audit logs and role management; the organization secret key alone adds org-wide user deletion.
Paste the keys into PopMCP
Paste into API Key and Secret Key. If you collected extras, open More options and fill the matching fields: Personal Access Token (optional), Experiment Management API key (optional), Experiment deployment key (optional), SCIM key (optional, Enterprise), Organization API key (optional, Enterprise) and Organization secret key (optional, Enterprise). Leave Organization ID (optional) and Project ID (optional) blank unless a tool asks for them.
Connect in PopMCP
Open your workspace, choose Amplitude in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| API Keytext | In Amplitude: Settings (gear icon) > Organization settings > Projects > pick the project > General > API Key. Only Admins and Managers can see it. One connection is one project. |
| Secret Keysecret | On the same General tab: Secret Key (Manage > copy). Newer projects show it only once, under Organization settings > API Keys. Stored encrypted.Encrypted with AES-256-GCM on save and never shown again. |
| Personal Access Token (optional)secret | Unlocks saved charts (find by name, run), the project list, destinations, heatmaps and the newer taxonomy and flag endpoints. Create it in Amplitude under your profile settings > Personal access tokens. It acts with your own permissions.Encrypted with AES-256-GCM on save and never shown again. |
| Experiment Management API key (optional)secret | Unlocks feature flags, experiments, deployments, mutex and holdout groups, and lets the evaluation tools pick a deployment for you. In Amplitude: Experiment > Management API (bottom of the left sidebar) > Create API key.Encrypted with AES-256-GCM on save and never shown again. |
| Experiment deployment key (optional)secret | Only for evaluating flags against one specific deployment without a management key. Experiment > Deployments > copy the key.Encrypted with AES-256-GCM on save and never shown again. |
| SCIM key (optional, Enterprise)secret | Unlocks SCIM user and group provisioning. Organization settings > Access and SSO settings > Provisioning > Generate SCIM key (shown once).Encrypted with AES-256-GCM on save and never shown again. |
| Organization API key (optional, Enterprise)secret | With the organization secret key, unlocks data access requests (DSAR), audit logs and role management. Issued by Amplitude Support.Encrypted with AES-256-GCM on save and never shown again. |
| Organization secret key (optional, Enterprise)secret | Pairs with the organization API key. On its own it also unlocks org-wide user deletion (Settings > API Keys > Org-level Secret Keys).Encrypted with AES-256-GCM on save and never shown again. |
| Organization ID (optional)text | Needed by the organization-level tools. Found automatically when you add a Personal Access Token; otherwise copy it from Organization settings. |
| Project ID (optional)text | Usually found automatically. Set it if tools ask for a project id: Settings > Organization settings > Projects > General > Project ID. |
PopMCP verifies the credential against Amplitude immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
PopMCP shows Amplitude as Verified with a label such as project 123456 (US), or the organization and project names when a Personal Access Token supplied them. Ask which events were tracked last week: amplitude_list_events returns your event names instead of an Invalid API Key error.
Troubleshooting
"Amplitude rejected this API Key and Secret Key on both its US and EU data centers"
Why: One of the keys was mis-copied or revoked, or the Secret Key belongs to a different project than the API Key.
Fix: Copy the API Key again and generate a fresh Secret Key on the same project under Organization settings, API Keys, then reconnect.
"The API Key and Secret Key are the same value"
Why: The API Key was pasted into both fields.
Fix: Generate a Secret Key for the project and paste it into Secret Key. The two are always different strings.
"Amplitude rejected the Personal Access Token" (or another optional key)
Why: The extra key was revoked, mis-copied, or belongs to another organization or region than the project.
Fix: Create a new one where the field's help says, or leave that field blank: the connection works without it.
A tool says it needs an Experiment Management API key, a SCIM key or organization keys
Why: That tool belongs to an API the two project keys can't reach.
Fix: Add the named key under More options on the connection. The error message says where to create it in Amplitude.
429 from chart, funnel or user tools
Why: Amplitude allows 5 concurrent REST requests per project and a cost budget per hour and per five minutes; User Activity and User Search are capped at 360 queries an hour.
Fix: Wait a few minutes, then ask for fewer charts at once or a shorter date range.
get_user_profile fails on an EU project
Why: Amplitude offers the User Profile API for US projects only.
Fix: Use search_users and get_user_activity instead, which work in both regions.
Event export says the file is larger than 50 MB
Why: The requested hours hold more raw event data than PopMCP downloads in one call.
Fix: Ask for a narrower UTC hour range, or filter by event type or user.
Reference
Ahrefs
Connect Ahrefs to research backlinks, organic keywords, competitors, rank tracking, site audits, and domain ratings. MCP setup for Claude and ChatGPT.
Apify
Connect Apify to run web scraping actors and tasks, control runs, and read datasets, stores, and request queues. MCP setup guide for Claude and ChatGPT.