# Gainsight PX MCP > Gainsight PX connects your product analytics and engagement data directly to your AI client. It lets you query user behavior, retrieve account metadata, log custom backend events, and check which features are being tracked—all through natural conversation. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** product-analytics, in-app-engagement, product-led-growth, user-behavior, adoption-metrics, event-tracking ## Description This MCP gives your agent the ability to read deep into how users interact with your software. Instead of logging into a dashboard, you can simply ask about specific segments or behaviors. You'll get details on user profiles, including who they are and what devices they use. It also lets you track custom interactions from your backend code, enriching your data set without touching the front end. Need to know if a feature is even being tracked? You can list all product features for an answer. This connectivity allows you to run sophisticated product analysis directly through any MCP-compatible client connected via Vinkius. ## Tools ### verify_api_connection Checks if the provided API key and region details are valid and connected to Gainsight PX. ### get_account_details Retrieves specific metadata for a given account ID. ### get_my_identity Fetches the profile data associated with the authenticated user running the query. ### get_user_details Retrieves detailed metadata for a specific user ID within Gainsight PX. ### identify_px_account Syncs or updates an existing account profile record, ensuring accurate identity mapping for future events. ### identify_px_user Syncs or creates a user profile record, linking a person's identity to the Gainsight PX data set. ### list_px_accounts Queries and lists multiple accounts based on provided filters (e.g., date range, status). ### list_px_engagements Retrieves a list of all active in-app guides, surveys, and sliders currently configured for tracking. ### list_product_features Lists every single product feature that Gainsight PX is currently monitoring usage data for. ### list_px_products Queries and lists the specific products managed within your Gainsight PX account. ### list_px_users Lists multiple user profiles, allowing you to filter by criteria like last login date or email domain. ### track_server_event Logs a custom interaction event directly from your backend code into the product usage dataset. ## Prompt Examples **Prompt:** ``` List all PX users who were last seen in the past 24 hours. ``` **Response:** ``` Querying users... I found 15 users active in the last 24 hours, including 'john.doe@example.com' and 'alice.smith@provider.com'. Would you like the full profile for any of them? ``` **Prompt:** ``` Identify a new account 'Globex Corp' with ID 'acc_98765'. ``` **Response:** ``` Account identified! I have successfully synchronized 'Globex Corp' (ID: acc_98765) to your Gainsight PX environment. Any future events for this ID will be attributed to this account. ``` **Prompt:** ``` Track a custom event 'Clicked Upgrade Button' for user 'user_123'. ``` **Response:** ``` Event tracked! The 'Clicked Upgrade Button' event has been successfully logged for user_123. This data will now appear in your product usage analytics. ``` ## Capabilities ### Identify and manage user profiles The agent fetches existing user details or creates new profile records based on provided identifiers. ### Track custom backend events You send a specific event name, and the MCP logs it against your product usage data set. ### List account and user lists The agent queries Gainsight PX to retrieve filtered lists of accounts or individual users. ### Check engagement assets You list all active in-app guides, surveys, and sliders that are currently deployed for tracking. ### Review product instrumentation The agent lists every single product feature that your current setup is configured to track. ## Use Cases ### Need to segment users who haven't logged in recently? A Product Manager asks their agent, 'List all PX users last seen in the past 30 days.' The MCP immediately runs list_px_users and returns a clean list of stale accounts, allowing them to start an immediate re-engagement campaign. ### An enterprise client triggers a high-value action. The Customer Success Ops team needs to record this event. They use track_server_event with the specific event name and account ID, guaranteeing that the critical interaction is logged instantly for reporting. ### Debugging product usage data after a deployment. A Growth Engineer runs list_product_features to confirm that the new 'Settings' widget was successfully added to the tracking scope. The agent confirms its status and provides associated metadata. ### Onboarding a massive batch of existing customers. The team uses identify_px_account repeatedly, feeding in bulk IDs and ensuring every corporate account is correctly synced before running any adoption metrics on the full list. ## Benefits - Get immediate insights on who's using your product. Instead of manually navigating, you can ask the agent to list users or accounts based on custom criteria, saving minutes every time. - Improve data accuracy by managing identities programmatically. Use identify_px_user and identify_px_account to ensure that new signups are instantly linked to the correct profile record. - Track interactions outside of the UI. The ability to track_server_event means you can log critical actions from your backend code, enriching data sets without client-side development work. - Audit your tracking coverage with simple commands. list_product_features lets you quickly confirm if a new or old feature is actually being monitored for usage data. - Understand your communication strategy by listing active guides and surveys. Using list_px_engagements gives you an immediate overview of every in-app asset currently deployed. ## How It Works The bottom line is you use natural language to get answers that usually require navigating multiple dashboards and running complex filters. 1. Subscribe to this MCP through the Vinkius Marketplace and enter your Gainsight PX API Key. 2. Your AI client connects using the credentials, verifying access to both US or EU data centers. 3. You ask your agent a question—like 'What were the top five features used last week?'—and it returns structured product insights. ## Frequently Asked Questions **Can Gainsight PX MCP list all users who signed up last week?** Yes, you can list multiple user profiles using the list_px_users tool. You just need to provide filters like a specific date range or status for the query. **How do I log an event from my backend code with Gainsight PX MCP?** You use the track_server_event tool. This allows you to send custom interaction events directly into your product usage data without having client-side code changes. **What is the difference between get_user_details and list_px_users?** list_px_users fetches a *list* of user profiles based on criteria. get_user_details retrieves all the deep metadata for one specific, known user ID. **Does Gainsight PX MCP help me figure out what features are being tracked?** Yes, you can list all product features using list_product_features. This is essential for auditing your instrumentation coverage across the platform. **Can I update a user profile with Gainsight PX MCP?** You use identify_px_user to sync or update an existing user's profile, ensuring that their identity mapping remains accurate in the system. **How do I get an API Key for Gainsight PX?** Log in to Gainsight PX, go to Administration > Products, select your product, and you will find the API Key in the product settings. **Which region should I select?** Select 'US' if your account is hosted at api.aptrinsic.com, or 'EU' if it is hosted at api-eu.aptrinsic.com. **Can I identify new users through the agent?** Yes! Use the 'identify_px_user' tool and provide a unique 'identifyId'. The agent will create or update the user profile in Gainsight PX instantly. **Does this server support tracking custom events?** Yes, the 'track_server_event' tool allows you to log custom behavioral events for any identified user directly from your backend or chat interface.