Skip to main content

Amplitude - Analytics & Dashboards

Access Amplitude's analytics, dashboard, export, cohort, and taxonomy APIs. Use this connector to query user activity, export raw data, manage cohorts, retrieve chart data, and maintain your event taxonomy.

When to Use This Connector​

Use this connector when you need to:

  • Export raw event data for data warehousing or backup
  • Query user activity and event history
  • Manage and analyze cohorts
  • Retrieve data from saved charts and dashboards
  • Run ad-hoc event segmentation queries
  • Maintain your event taxonomy
  • Comply with privacy regulations (GDPR/CCPA)

For sending events to Amplitude, see Amplitude - Event Ingestion. For user profiles and recommendations, see Amplitude - User Profiles.

Authentication​

This connector uses API Key + Secret Key authentication in the Authorization header.

  • Credential Format: api_key:secret_key
  • Example: abc123xyz789:sk_def456uvw012

Important: Include both your API key and secret key separated by a colon with no spaces.

General Settings​

Before using the connector, configure your region:

  • Region - Select your Amplitude data region:
    • us - Standard US region (most common)
    • eu - European Union region for EU data residency

Setting up Authentication​

Step 1: Get Your Credentials​

  1. Go to amplitude.com and log in to your account
  2. Click on Settings (gear icon) in the top right corner
  3. Scroll to Connections → API Keys
  4. Click Generate API Key → Give it a name (e.g., "Webrix")
  5. Copy both the API Key and Secret Key

Important: The secret key is only shown once when generated. Make sure to copy it immediately.

Step 2: Configure in Webrix/MCP​

Enter your credentials in the format api_key:secret_key:

abc123xyz789:sk_def456uvw012

Note: Make sure there are no spaces before or after the colon.

Available Tools​

This connector provides 17 tools organized into 6 categories:

Export & Raw Data (3 tools)​

  • Export Events - Download raw event data for data warehousing, backup, or custom analysis
  • Get User Activity - Retrieve complete event history for a specific user
  • Search User Activity - Query user events within a specific time range

Cohorts (4 tools)​

  • List Cohorts - Get all behavioral cohorts in your project
  • Get Cohort - Retrieve detailed cohort information and metadata
  • Download Cohort - Export user IDs from a cohort for external use
  • Upload Cohort - Create or update cohorts from external sources

Dashboards & Charts (4 tools)​

  • Get Chart Data - Retrieve data from saved Amplitude charts
  • Run Event Segmentation - Perform ad-hoc event analysis queries
  • Get Active Users - Track DAU/WAU/MAU metrics
  • Get Dashboard List - List all available dashboards

Taxonomy (3 tools)​

  • List Event Types - Get all tracked events in your project
  • Get Event Type Details - View event schema and properties
  • Create or Update Event Type - Manage event definitions and documentation

Utility & Privacy (3 tools)​

  • Delete User Data - GDPR/CCPA compliant data deletion
  • Create Release - Mark app releases for version tracking
  • Add Chart Annotation - Add context to charts with annotations

Regional Differences​

US Region (Standard)​

  • API Endpoints: amplitude.com and api2.amplitude.com
  • All analytics features available

EU Region​

  • API Endpoints: analytics.eu.amplitude.com and api.eu.amplitude.com
  • All analytics features available
  • Data stays within EU boundaries for compliance

Troubleshooting​

"Invalid API key or secret key"​

Cause: The credentials are incorrect or not formatted properly.

Solution:

  • Verify you're using the format api_key:secret_key with a colon separator
  • Ensure there are no extra spaces or line breaks
  • Check that you copied the complete API key and secret key
  • Verify the secret key hasn't been regenerated (old keys are invalidated)

"Region mismatch" or "404 Not Found"​

Cause: You selected the wrong region for your Amplitude project.

Solution:

  • Check your Amplitude project's region in the project settings
  • Update the Region setting in the connector to match (us or eu)
  • EU projects must use the eu region setting

"Secret key only shown once"​

Cause: You navigated away from the secret key page without copying it.

Solution:

  • You'll need to regenerate the secret key
  • Click "Create Secret Key" again in project settings
  • This will invalidate the old secret key
  • Copy the new secret key immediately

Rate Limits​

Amplitude has rate limits on its APIs:

Export API

  • Maximum 4 GB per request
  • Maximum 365 days per query
  • May timeout (504 error) if data is too large

Dashboard REST API

  • 5 concurrent requests
  • 1,000 cost per 5 minutes
  • 108,000 cost per hour

Solution:

  • Break large queries into smaller date ranges
  • Implement exponential backoff for rate limit errors (429 status)
  • For exports, consider using smaller time windows

Best Practices​

  1. Export Data Incrementally: Use Export Events with smaller time ranges for large datasets
  2. Cache Chart Data: Cache frequently accessed chart data to reduce API calls
  3. Cohort Management: Use meaningful names and descriptions for cohorts
  4. Event Taxonomy: Maintain consistent event definitions using the taxonomy tools
  5. Rate Limiting: Implement retry logic with exponential backoff
  6. Date Formats: Use the correct date format for each API (YYYYMMDD vs YYYY-MM-DD)

Additional Resources​