# Convertlab MCP MCP > Convertlab MCP connects your AI client directly to the DM Hub marketing platform. Manage everything from customer profiles and segment lists to active campaign performance and granular behavioral events—all through natural conversation. Stop clicking through dashboards; just ask your agent for what you need. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** customer-segmentation, campaign-management, behavioral-data, marketing-ops, customer-profiles ## Description Need to audit a customer's journey or track why a specific campaign is failing? Instead of navigating the complex DM Hub interface, simply talk to your AI agent. It pulls all the necessary data—customer lists, behavioral events, and marketing performance metrics—and presents it in real-time. Your agent acts like an instant marketing operations assistant, handling deep dives into customer records or checking segmentation groups without you ever leaving your chat window. Because this MCP is hosted on Vinkius, you connect once from any compatible client and get access to Convertlab's full data set. You can ask it to list customers, check the details of a specific campaign, or even pinpoint exactly what actions triggered an engagement event. ## Tools ### create_customer Creates a brand new user account record in DM Hub. ### get_campaign Retrieves the specific performance details for one marketing campaign. ### get_customer Fetches all detailed data associated with a single customer profile. ### list_campaigns Provides a list of all active and past marketing campaigns available in the system. ### list_customers Returns an enumerable list of every customer account within DM Hub. ### list_events Generates a detailed feed of behavioral events, showing what customers did. ### list_member_groups Lists all existing membership groups used for customer segmentation. ### list_touchpoints Retrieves metadata on every specific interaction point a customer had with the brand. ## Prompt Examples **Prompt:** ``` List all my DM Hub customers. ``` **Response:** ``` I've retrieved your Convertlab customers. You have 1,500 total members, including 150 high-value segments marked with loyalty tags. Would you like to view the details of the most recent ones? ``` **Prompt:** ``` Show me the details for campaign 'Spring-2026'. ``` **Response:** ``` I've retrieved the details for 'Spring-2026'. The campaign is currently active with a 45% conversion rate across 5 target touchpoints. Would you like a breakdown of the behavioral events triggered by this campaign? ``` **Prompt:** ``` List all customer segmentation groups. ``` **Response:** ``` I've listed your member groups. There are 12 segments defined, including 'Repeat Buyers', 'Inactive-30-Days', and 'VIP-Tier-1'. Which segment would you like to see the member count for? ``` ## Capabilities ### Track customer history Retrieve detailed profiles and membership information for any listed DM Hub customer. ### View campaign performance Get metadata on active or historical marketing campaigns, including their current status and metrics. ### Audit user behavior List specific behavioral events to track how users interact with your content over time. ### Manage customer groups Browse all predefined membership groups and identify potential target segments for campaigns. ### Identify marketing touchpoints Get metadata about every point where a customer interacted with your system, from emails to ads. ## Use Cases ### Auditing a struggling campaign A marketer asks their agent: 'Show me the performance of Campaign X and list all behavioral events for customers who saw it but didn't convert.' The agent instantly gathers data from get_campaign, list_events, and potentially get_customer to pinpoint why people dropped off. ### Auditing a customer segment A team member wants to know the size of their 'High-Value' segment. They ask the agent to list_member_groups and then use list_customers on that specific group, getting an accurate count immediately. ### Handling a support inquiry A customer service rep asks: 'What were all the marketing touchpoints for this user over the last month?' The agent uses get_customer and list_touchpoints to build a complete history, eliminating manual research. ### Preparing for an upsell A sales lead asks: 'Who are our most engaged customers who haven't been targeted by Campaign Y?' The agent combines the data from list_customers with list_events to find ideal targets for a new campaign. ## Benefits - You don't need to click through 5 different tabs. Your agent handles the complexity of querying customer profiles, campaign metrics, and event logs in one go. - Instead of running manual reports on behavioral data, you simply ask your agent to list events for a specific user, getting instant insight into their journey. - When launching new outreach efforts, you can instantly check all existing membership groups to ensure your target segment is correctly defined before sending anything out. - Need to onboard a high-value client? Use the ability to get customer details and immediately cross-reference it with their full list of touchpoints for context. - Setting up new accounts is simple: you can use the tool to create_customer records directly, keeping your data fresh without manual entry. ## How It Works The bottom line is that once connected, you treat complex marketing data like simple conversation prompts. 1. Subscribe to this MCP and provide your Convertlab App ID and Secret keys. 2. Connect the credentials to your preferred AI client (Claude, Cursor, etc.). 3. Start by asking your agent a direct question, like 'List all customers in the VIP segment,' and it handles the rest. ## Frequently Asked Questions **How do I use the list_customers tool with Convertlab?** You ask your agent to list all customers. It retrieves an enumerable list of every DM Hub customer, giving you a starting roster for any deep dive. **What is the difference between list_events and get_customer using Convertlab?** list_customers gives you who exists. get_customer provides detailed data on one person. list_events shows *what* those people did—the actual actions taken. **Can I use the create_customer tool to add new users?** Yes, you can use the create_customer tool to quickly build a new user record in DM Hub if you need to onboard someone manually and fast. **How do I check campaign performance with list_campaigns using Convertlab?** You first run list_campaigns to see all options, then ask the agent to get_campaign for the specific one you want details on. It pulls the full metric report. **What information do I need to connect my AI agent to use the Convertlab MCP?** You'll need your dedicated Convertlab App ID and App Secret. These credentials manage access to all tools, including list_customers and get_campaign. Always treat these keys as sensitive data. **If I run the list_events tool repeatedly, is there a limit on how much data I can pull?** Yes, rate limits apply to maintain platform stability. If you hit a ceiling, your agent will get an error code. Try spacing out large queries or requesting only specific date ranges. **How can I scope down my search when using the list_members_groups tool?** You must pass filtering parameters in your query. Instead of listing all groups, specify criteria like a certain membership status or creation date to narrow results immediately. **What should I do if the get_customer tool returns an 'Access Denied' error?** This usually means the credentials used don't have read permissions for that specific customer record. Check your App ID and App Secret settings within Convertlab. **How do I find my Convertlab App ID and Secret?** Log in to your Convertlab DM Hub admin portal, go to [Settings] → [App Management], and you will find your App ID and Secret there. Ensure your application has the required API scopes enabled. **Can I see customer behavioral events through this server?** Yes. Use the `list_events` tool to retrieve historical behavioral data from your customers. This is essential for auditing engagement and understanding customer journeys. **Is it possible to monitor campaign performance?** Yes! Use the `list_campaigns` tool to see all active and past marketing campaigns and `get_campaign` with a specific ID to retrieve detailed performance metrics and configuration.