# Campaigner MCP MCP > Campaigner MCP connects your AI agent directly to Campaigner's marketing tools. You can manage subscriber lists, track campaign performance, and run automated workflows—all through natural conversation. It lets you list all campaigns, create new subscribers, or grab real-time stats without logging into a dashboard. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** email-campaigns, subscriber-management, automation, reporting, multi-channel-marketing, contact-lists ## Description Think of this MCP as the control panel for your entire email strategy. Instead of clicking through five different tabs in your marketing platform, you talk to your AI agent and it does the work. Need to see how well last month's promotion landed? Ask your agent to pull performance stats. Want to add a batch of new leads from a spreadsheet? Tell your agent to create subscribers for them right away. You can list every segment or track down a specific user’s profile history—all in one conversation. When you connect Campaigner via Vinkius, your AI client gains instant access to the entire suite of marketing tools. This means your digital strategists and developers can manage everything from audience segmentation to multi-channel campaign execution without ever leaving their chat window. ## Tools ### create_subscriber Adds one or more new contacts directly to your Campaigner account. ### get_account_info Pulls core details about your overall Campaigner account settings and limits. ### get_campaign_stats Gets performance metrics like open rates or click-through numbers for any given campaign ID. ### get_campaign Retrieves the setup and detailed information for a specific email campaign. ### get_subscriber Looks up a single user's complete profile using their email address. ### list_campaigns Provides a list of every campaign you have set up in the platform. ### list_publications Shows all your defined contact lists or publication groups. ### list_segments Retrieves a list of all audience segments you've created for targeted sending. ### list_subscribers Lists every individual subscriber currently in your main newsletter database. ### list_workflows Shows the names and status of any automated, scheduled email workflows. ## Prompt Examples **Prompt:** ``` List all my email campaigns in Campaigner. ``` **Response:** ``` I've retrieved your campaigns. You have several active and draft campaigns, including 'Spring Promo' (ID: camp_1) and 'User Onboarding' (ID: camp_2). ``` **Prompt:** ``` Show the stats for campaign ID 12345. ``` **Response:** ``` Retrieving stats for campaign 12345... It has a 25% open rate, a 5% click rate, and has been sent to 1,000 subscribers. ``` **Prompt:** ``` Search for subscriber with email john.doe@example.com. ``` **Response:** ``` I've found the subscriber profile for John Doe. He is currently 'Subscribed' and is associated with the 'Customers' and 'Weekly Update' lists. ``` ## Capabilities ### Check Subscriber Details Retrieve individual user profiles, including contact data and full activity history. ### Manage Campaigns List all existing email campaigns and pull detailed metadata about subjects or automated sequences. ### Measure Performance Get live statistics, like open rates or click counts, for any specific campaign run. ### Segment Audience Lists List all configured audience segments and publications to confirm your contact lists are ready. ### Grow Your List Add new contacts directly to Campaigner using simple language commands. ## Use Cases ### The Launch Readiness Check A marketer needs to launch a new product promotion. Instead of manually checking the campaign status, they ask their agent: 'What campaigns are active and what segments do I need?' The agent runs `list_campaigns`, then checks `list_segments` and reports back on readiness. ### The Data Clean-up An ops engineer gets a fresh CSV of 500 leads. They don't want to manually enter them. They tell their agent, 'Add these new contacts,' and the agent executes `create_subscriber` for all records in one go. ### The Performance Deep Dive A strategist wants to know why Campaign Alpha underperformed last week. They ask the agent to pull stats using `get_campaign_stats`, and immediately get a comparison to the previous month's metrics, all without leaving their main planning session. ### The User Lookup A customer service rep has a complaint about an old email. They ask the agent for the user’s profile by email, using `get_subscriber`, and instantly see if that person is even subscribed or which list they belong to. ## Benefits - Stop switching tabs. You can list all your email campaigns and pull segment details—all in one conversational turn with your AI agent. - Gauge ROI instantly. Instead of digging through dashboards to find metrics, ask your agent for `get_campaign_stats` directly from the chat window. - Grow leads effortlessly. Use the natural language call to create a subscriber, adding new contacts without needing a manual form submission. - Know who you're talking to. You can pull detailed profiles using `get_subscriber` and see exactly what history that user has with your brand. - Audit everything easily. Need to know if an automated sequence is running? List all workflows using `list_workflows` straight from your planning tool. ## How It Works The bottom line is you talk to your agent, and it talks to Campaigner for you. 1. Subscribe to this MCP and input your Campaigner API Key. 2. Your AI agent reads the available tools and waits for a prompt about marketing tasks. 3. You ask your agent something like, 'What were the stats for the Q3 promo?' and it executes the necessary calls. ## Frequently Asked Questions **How do I add a new subscriber using the create_subscriber tool?** You prompt your agent with the person's details and email. It runs `create_subscriber` in the background, adding them to Campaigner without you ever seeing the API call. **Can I check campaign stats using get_campaign_stats?** Yes. You just need to provide the campaign ID, and your agent executes `get_campaign_stats` to pull live performance metrics for you immediately. **Is list_subscribers better than get_subscriber?** It depends on what you need. Use `list_subscribers` if you want a bulk overview of every single person. Use `get_subscriber` when you know the email and only need to check one specific profile. **What is list_workflows?** The `list_workflows` tool simply shows you all the automated, scheduled emails that are set up in Campaigner. It’s useful for checking if sequences are running as expected. **How do I verify my Campaigner account details after connecting the MCP using get_account_info?** The tool immediately returns core account data, confirming your API key is valid. You'll see basic metrics like your account name and unique ID. This confirms connectivity before you try running complex tasks. **When I run list_publications, what information can I expect about my contact lists?** It provides a full list of all your defined 'Publications' (contact lists). Each entry includes the publication name and its unique ID. This lets you quickly confirm which audience segments are available for targeting. **If I need an overview of all my email campaigns, should I use the list_campaigns tool?** Yes, `list_campaigns` fetches a comprehensive list of every campaign you own. This includes basic metadata like the subject line and whether the campaign is currently active or still in draft status. **If I use get_subscriber with an invalid email address, how will the MCP handle the error?** The tool sends a clear error response stating that no subscriber was found for that specific email. This lets your agent handle the issue gracefully and prompt you for correct information without failing. **Can I check the statistics for a specific campaign using the agent?** Yes! Use the `get_campaign_stats` tool with the Campaign ID. Your agent will fetch the detailed performance data, including open rates, clicks, and bounces, directly from Campaigner. **How do I list all the subscribers in my account?** Simply ask the agent to `list_subscribers`. It will retrieve the list of contacts from your Campaigner account, including their status and primary details. **Does the integration allow adding a new subscriber?** Yes. Use the `create_subscriber` action and provide the email address. The contact will be added to your Campaigner account immediately.