# Aimtell MCP MCP > Aimtell MCP connects your web push notification system directly to your AI agent. You manage all campaigns, audit subscriber segments, and pull real-time performance analytics—all through natural conversation. It handles everything from running one-off alerts to checking the technical criteria of a segment without you needing to log into multiple dashboards. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** push-notifications, re-engagement, campaign-management, subscriber-segmentation, web-marketing, real-time-analytics ## Description Need to run a re-engagement campaign? Your agent takes care of it. You don't need to jump between dashboards or pull up dozens of reports just to figure out if your targeting is correct; you ask, and the data appears right in chat. The system handles everything from listing all available campaigns to checking granular performance metrics for specific sends. If you're working with complex subscriber lists, you can easily review segment criteria and even update custom user attributes on the fly. This ability to orchestrate entire marketing strategies—from initial targeting to final analytics report—is what makes this MCP so useful. It’s integrated into the Vinkius catalog, giving your agent access to all of its tools right where you are working. ## Tools ### list_sites Lists all websites that are currently linked to your Aimtell account. ### list_subscribers Retrieves a list of all site subscribers associated with the connected accounts. ### get_subscriber_details Pulls all available metadata about a specific subscriber account. ### list_segments Provides an audit list of defined subscriber segments for review and targeting planning. ### list_campaigns Gets a full catalog listing of all manually created push notification campaigns. ### send_one_off_notification Dispatches an immediate alert to a defined group of subscribers. ### list_triggered_campaigns Lists automated, rule-based campaigns (like welcome series or abandoned cart flows). ### get_campaign_performance Retrieves key metrics, including clicks and sends, for any given campaign ID. ### add_subscriber_attribute Applies custom data points directly to a specific subscriber's profile. ### list_api_campaigns Retrieves the list of campaigns that are triggered automatically via API. ## Prompt Examples **Prompt:** ``` List all active segments in my Aimtell account. ``` **Response:** ``` I've retrieved your segments. You have 8 active segments, including 'High Intent Buyers', 'Blog Readers', and 'New Signups'. Would you like to see the subscriber count for any of them? ``` **Prompt:** ``` Show me the performance for campaign ID 12345. ``` **Response:** ``` I've pulled the analytics for campaign 12345. Total sends: 50,000, Total clicks: 1,250 (2.5% CTR), and 15 conversions generated. The performance is currently within your expected range. ``` **Prompt:** ``` Send a one-off push to segment 9876 with title 'Special Offer' and body 'Get 20% off today only!'. ``` **Response:** ``` I've triggered the one-off notification to segment 9876. The alert is now being delivered to all eligible subscribers. You can check the real-time click statistics in a few minutes. ``` ## Capabilities ### Run targeted alerts Send immediate web push notifications to specific groups or individuals. ### Audit subscriber lists Get detailed metadata on subscribers and verify segment rules. ### Manage marketing campaigns List, manage, and retrieve status for both standard and automated web push campaigns. ### Update user data points Add custom attributes to individual subscribers to refine future targeting. ### Analyze campaign results Pull real-time performance statistics like sends, clicks, and conversions for any campaign. ## Use Cases ### Running an urgent flash sale alert A manager realizes a competitor just launched something similar. They ask their agent to 'Send one-off notification' immediately to the 'High Intent Buyers' segment, bypassing planned campaigns entirely. ### Debugging campaign underperformance The marketing analyst notices CTRs are low for Campaign ID 456. They instruct their agent to call `get_campaign_performance` and quickly confirm if the issue is low sends or low click-through rates, pinpointing the failure point instantly. ### Retargeting a lapsed user group The growth specialist identifies a segment of users who haven't logged in for 60 days. They use `list_segments` to verify the criteria, then run `add_subscriber_attribute` on those users to flag them for a specific re-engagement campaign. ### Checking system scope A developer needs to confirm if their new landing page is linked. They use the agent to call `list_sites`, confirming the correct domain is active before building out any API campaigns. ## Benefits - Instant performance reports: Instead of downloading CSVs, ask the agent to call `get_campaign_performance` and get total sends, clicks, and conversions immediately in your chat. This is huge for quick debugging. - Precise targeting control: Need to adjust who gets an offer? You can list segments using `list_segments`, then refine it by running `add_subscriber_attribute` on key users. It keeps the whole process conversational. - Full campaign visibility: Don't just check active campaigns; you can use `list_campaigns` and `list_triggered_campaigns` together to see everything—manual, automated, or API-driven—in one place. - User profile deep dives: When a user complains about an alert, you don't have to guess. You run `get_subscriber_details` to pull all their metadata and check for issues right away. - Multi-site management: If your company runs several properties, use `list_sites` first. It ensures the agent is pointed at the correct domain before you try to send anything. ## How It Works The bottom line is you talk to your AI client, and it handles all the API calls needed to get the answer. 1. Subscribe to this MCP in Vinkius and enter your Aimtell API Key. This connects the agent to your account. 2. Ask your agent a specific question, like 'List all active segments' or 'Show performance for campaign X'. 3. The agent executes the required function and returns the raw data—the segment list, the metrics, or the status report—directly in the chat. ## Frequently Asked Questions **How do I check active segments using Aimtell MCP?** You run `list_segments` to see all defined groups. This function gives you a clear audit of every segment available for use in your push campaigns. **Can I send an ad-hoc alert with the Aimtell MCP?** Yes, you can call `send_one_off_notification`. This lets you bypass planned cycles and immediately alert specific subscribers or segments when needed. **How do I check campaign results using get_campaign_performance?** Use `get_campaign_performance` by providing the Campaign ID. It pulls metrics like total sends, click count, and conversion data in one call. **Is there a way to update subscriber data with Aimtell MCP?** Yes, you use `add_subscriber_attribute`. This function lets your agent write custom attributes directly onto individual user profiles for better segmentation later. **How do I see all the websites connected to my account via Aimtell MCP?** You call `list_sites` to get a definitive list of every domain or website that is currently integrated with your Aimtell account, confirming scope before deployment. **How do I check all types of campaigns, including automated or API-triggered ones, using Aimtell MCP?** You must use separate tools for different campaign types. Run `list_triggered_campaigns` to view scheduled alerts and `list_api_campaigns` to see programs sent via the API. This allows you to audit your full operational setup. **What does the `list_subscribers` tool return, and how is it different from checking specific metadata?** It returns a list of site subscribers with core details for quick inventory checks. If you need deep information on one person, use `get_subscriber_details`. Think of `list_subscribers` as the roster, not the profile. **When should I run `add_subscriber_attribute`? Does it affect campaign targeting?** You use this tool to manually input custom data points, like a user's job title or interest level. These new attributes become available for segmentation and greatly improve your personalization efforts. **Where do I find my Aimtell API Key?** Log in to your Aimtell dashboard, navigate to **Settings** > **API Key**. You will find your unique authorization key there. It must be used in the `X-Authorization-Api-Key` header. **Can I send a notification to a specific segment?** Yes! Use the `send_one_off_notification` tool and specify the `segmentId`. Your agent will trigger the push alert to all subscribers currently in that segment. **Does this support tracking custom attributes?** Yes, you can use the `add_subscriber_attribute` tool to enrich subscriber profiles with custom data (like name or interests), which can then be used for dynamic content in notifications.