# Amplitude MCP for AI Agents AI Agent Connect > Amplitude MCP for AI Agents. Stop jumping between tabs to check your product metrics. Use this Connector to query user behavior, manage cohorts, and pull raw event data directly through your AI agent. It turns Amplitude into a conversational data source for your team. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_baDXqb9sIu68FhrLqdFsEmQuOXSS9cE3CIqTfWur/ai-agent-connect - **Tags:** product-analytics, user-tracking, event-ingestion, cohort-analysis, data-export ## Description Amplitude lets you query user behavior, pull real-time profiles, and manage cohorts directly through your AI agent. Instead of jumping between tabs and manually filtering data, you can just ask your agent to find specific user segments or export raw event logs. This Connector makes it easy to handle high-volume event ingestion, manage your taxonomy, and even process data deletion requests for GDPR compliance. You can get a clear picture of how people are actually using your product without the usual friction of manual data pulling. By adding this to your Vinkius catalog, you turn your analytics suite into a conversational tool that helps you move faster. You can check experiment variants, identify high-value users, and keep your data clean, all from a single chat interface. ## Tools ### create_release Mark a release to measure its impact on your metrics. It helps you see how new code changes affect user behavior. ### delete_users Submit data deletion requests to comply with GDPR or CCPA. This helps you manage user privacy requests efficiently. ### export_data Get raw event data in JSON format for external use. You can use this to move data into other analysis tools. ### get_audit_logs View administrative activity logs for security audits. This keeps your account activity transparent and secure. ### get_experiment_variant See which experiment variant a specific user is in. This is great for debugging specific user experiences. ### get_user_profile Get real-time data and properties for a specific user. This helps you understand an individual user's journey. ### group_identify Update properties for specific user groups. Use this to segment users based on shared characteristics. ### identify_user Update a user's properties without creating a new event. This is a clean way to update profiles without cluttering your data. ### list_categories View all event categories in your taxonomy. This helps you maintain a consistent data structure across your product. ### list_cohorts See all behavioral cohorts currently in your project. Use this to see who is currently in your active segments. ### list_user_properties View all user properties across your dataset. This is useful for understanding what data points you're currently tracking. ### map_user Connect one user ID to another for global tracking. Use this to merge identities across different platforms. ### get_segmentation Pull metrics that appear in your Amplitude charts. Use this to get specific numbers for your target segments. ### list_event_types See every event type currently in your system. Use this to check your existing taxonomy at a glance. ### create_annotation Add important dates to your charts. This helps provide context for sudden spikes or drops in your metrics. ### create_category Add a new event category to your taxonomy. This keeps your data organized as you launch new features. ### list_event_properties See all properties associated with your events. This helps you verify the data structure of your events. ### send_attribution Send partner attribution data to Amplitude. This helps you track where your users are coming from. ### send_batch_events Send large amounts of data using the Batch API. This is the best way to handle high-volume data ingestion. ### send_events Send an array of event objects to the Amplitude cloud. Use this for sending real-time events as they happen. ### upload_cohort Create a new cohort by uploading a list of user IDs. This is perfect for creating segments from external lists. ## Prompt Examples **Prompt:** ``` What is the current status of user_99? Are they in any special cohorts? ``` **Response:** ``` I've pulled the profile for **user_99**. Here is the summary: * **Status:** Active * **Cohorts:** * Power Users * Early Adopters * **Properties:** * `subscription_plan`: Premium * `last_login`: 2023-10-24 They are currently showing high engagement with the new dashboard feature. ``` **Prompt:** ``` Can you show me the segmentation metrics for our 'Trial_Signups' event? ``` **Response:** ``` Here are the current metrics for the **Trial_Signups** event: | Metric | Value | | :--- | :--- | | Total Events | 12,450 | | Unique Users | 8,920 | | Conversion Rate | 71.2% | *Note: These figures are pulled from your active Amplitude charts.* ``` **Prompt:** ``` I need to export the raw data for the 'Login_Success' event from the last hour. ``` **Response:** ``` I've initiated the export for **Login_Success** events from the last hour. * **Format:** JSON * **Status:** Processing * **Estimated Completion:** 2 seconds You can grab the raw data from the download link once it's ready. ``` ## Capabilities ### Send high-volume batch events Push large amounts of data to Amplitude using the Batch API. ### Fetch real-time user profiles Get current user properties and cohort memberships instantly. ### Query segmentation metrics Pull specific metrics for events and segments in plain English. ### Create and upload cohorts Build new behavioral cohorts from external lists of user IDs. ### Manage event taxonomy Organize your data by creating categories and properties. ### Export raw event data Get raw JSON data for use in external tools or deep analysis. ### Retrieve experiment variants See which test variant a specific user is assigned to. ## Use Cases ### Identifying Churn A PM asks the agent to find users who haven't logged in for 10 days but were previously in the 'Power User' cohort. ### Quick Experiment Checks A growth engineer asks which variant a specific user is seeing to debug a reported UI bug. ### Data Cleanup An analyst uses the tool to export raw JSON for a specific hour to verify how a new tracking pixel is firing. ### Rapid Cohort Creation A marketer uploads a list of 500 emails to create a 'VIP' cohort for a new announcement. ## Benefits - Get instant answers on user behavior without opening the Amplitude dashboard by using `get_segmentation` to pull specific metrics. - Handle high-volume data ingestion efficiently by using `send_batch_events` to push large amounts of data to the cloud. - Manage your data governance more effectively by using `create_category` and `list_categories` to keep your taxonomy clean. - Perform real-time user lookups with `get_user_profile` to see exactly what properties and cohorts a specific user belongs to. - Automate cohort management by using `upload_cohort` to build new segments from external lists of IDs. - Export raw event data in JSON format using `export_data` for use in your own custom analysis or external tools. ## How It Works The bottom line is you get a conversational interface for your entire Amplitude analytics suite. 1. Subscribe to the Amplitude MCP on the Vinkius marketplace. 2. Provide your Amplitude API Key and Secret Key in the configuration. 3. Start asking your AI client to pull metrics or send events. ## Frequently Asked Questions **Can the Amplitude MCP help me find specific users?** Yes, it lets you fetch real-time profiles and see exactly which cohorts a specific user belongs to. **Can I use this to send data to Amplitude?** You can send single events or high-volume batches directly to your account using natural language instructions. **Does the Amplitude MCP work with my existing cohorts?** It can list all your current behavioral cohorts and let you create new ones from external lists of IDs. **Can I use this for GDPR requests?** Yes, it includes a tool to submit data deletion requests for your users to help you stay compliant. **How does this help with product experiments?** It lets you check which experiment variant a specific user is assigned to in real time for easier debugging. **Can I export data for my own reports?** You can export raw event data in JSON format for use in your own custom analysis or external tools. **Can I export raw event data for a specific time range?** Yes. Use the `export_data` tool by providing the start and end times in YYYYMMDDTHH format to retrieve raw event data in JSON format. **How do I check which cohorts a specific user belongs to?** You can use the `get_user_profile` tool with the specific Amplitude User ID. It will return the user's profile, recommendations, and all active cohort memberships. **Is it possible to update user properties without sending a new event?** Yes, the `identify_user` tool allows you to set, unset, or append user properties via the Identify API without triggering a separate event.