# Buttondown MCP MCP > Buttondown manages your entire newsletter pipeline directly through natural language. Use this MCP to list subscribers, track detailed email analytics, draft new campaigns, or add new contacts—all without opening a dashboard. Your agent handles subscriber oversight, campaign creation, and performance monitoring for immediate marketing action. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** email-marketing, newsletter, subscriber-management, analytics, campaign-management ## Description Need to run an email campaign but don't wanna spend hours clicking through dashboards? This MCP connects your AI client directly to your Buttondown account. You can manage the whole newsletter process using just conversation. Want to check how last week’s update performed? Just ask for the analytics. Need a new draft? Your agent can create it and even add subscribers with specific tags, keeping everything organized. It's all about talking to your marketing stack instead of clicking through menus. When you connect this MCP via Vinkius, you get one place where your AI client handles subscriber lists, email drafts, and campaign performance metrics right in your workflow. ## Tools ### create_email Generates brand new email campaigns or saves them as drafts for later review. ### create_subscriber Adds a specific person to your newsletter list, allowing you to set custom tags and metadata at the same time. ### get_account_info Retrieves core settings details for your entire Buttondown account profile. ### get_email_analytics Provides detailed reports, like open rates and click rates, for one particular sent email. ### get_email Fetches the full content and metadata for a single, specific email campaign or draft. ### get_subscriber Looks up and returns the complete profile details for one specific subscriber. ### list_emails Retrieves a list of all emails you've sent out, plus any drafts sitting in your workspace. ### list_newsletters Lists every newsletter account or campaign container set up within your Buttondown profile. ### list_subscribers Provides a comprehensive list of all current subscribers in the entire newsletter database. ### list_tags Displays every available tag, helping you verify how your subscriber base is currently categorized. ## Prompt Examples **Prompt:** ``` List all my newsletter subscribers. ``` **Response:** ``` I've retrieved your subscribers. You have 150 active subscribers, including 'john.doe@example.com' and 'jane.smith@example.com'. Would you like to see details for a specific subscriber? ``` **Prompt:** ``` Show analytics for my last sent email. ``` **Response:** ``` Retrieving analytics... Your last email 'Weekly Updates #42' has a 45% open rate and a 12% click rate from 150 recipients. ``` **Prompt:** ``` Create a new draft with subject 'Hello World' and body 'This is a test'. ``` **Response:** ``` Draft 'Hello World' has been successfully created in your Buttondown account with ID email_99283. ``` ## Capabilities ### Monitor Subscriber Lists Get a full list of all your newsletter subscribers and pull up detailed profiles for specific contacts. ### Manage Campaign Content Draft new email campaigns, create drafts, or send out emails without leaving your chat window. ### Analyze Performance Metrics Retrieve detailed open and click rates for any past sent email to see how well it performed. ### Categorize Audiences View all existing tags and ensure your subscriber base is properly segmented by category or metadata. ### Add New Contacts On the fly, add new subscribers to your list and assign them custom tags right from your agent's chat. ## Use Cases ### Analyzing a poor campaign performance The Marketing Manager asks their agent, 'Show me the analytics for last month's product launch email.' The agent calls `get_email_analytics` and immediately reports that the click rate was only 5%, pointing out exactly which part of the email needs fixing. ### Onboarding a new client list The Ops Specialist runs into an unsorted batch of contacts. They prompt their agent to 'Add these 20 people and tag them as VIP.' The agent uses `create_subscriber` twenty times, ensuring every single person gets the correct metadata. ### Creating a quick follow-up update The Content Creator realizes they need to send an ad hoc announcement. They prompt their agent: 'Draft a new email with subject X and body Y.' The agent uses `create_email`, generating the content immediately for review. ### Verifying segmentation rules The Digital Marketing Manager needs to know if they have a tag called 'Beta Tester' before launching. They ask, and the agent uses `list_tags` to confirm its existence, preventing an entire campaign from failing due to bad data. ## Benefits - You can check out the performance of an email using `get_email_analytics`, getting open rates and click counts immediately without manual dashboard navigation. It's instant data access. - Need to add a new contact? Use `create_subscriber` right through your agent. You can assign custom tags and metadata while you write, keeping your list clean from the start. - Never struggle with drafts again. With `list_emails` and `create_email`, you can see everything sent or waiting, and generate a whole new draft in one prompt. - Before hitting send, run through the full subscriber roster using `list_subscribers`. It's fast, giving you immediate oversight on list health. - Understand your entire account structure by running `list_newsletters` and checking core settings with `get_account_info`. Everything is centralized here. ## How It Works The bottom line is that it lets your AI client treat your entire newsletter platform like a set of functions you can call conversationally. 1. Subscribe to this MCP and enter your unique Buttondown API key. 2. Tell your AI client what you need—for example, 'Show me the analytics for the last weekly update.' 3. Your agent executes the request by communicating with your Buttondown account and returns the data directly. ## Frequently Asked Questions **How do I use `list_subscribers` with this MCP?** You prompt your agent to 'List all subscribers.' The MCP calls the tool and returns a clean list of every person currently signed up in Buttondown. **What's the difference between `get_email` and `list_emails`?** `list_emails` gives you an index—a table showing titles and dates for all your campaigns. `get_email` lets you dive deep into one specific email to read its full content. **Can I use `create_subscriber` without knowing their tags?** No, the tool is best used when you know the tags. You should prompt your agent: 'Add John Doe and tag him as Prospect.' This makes sure the data is clean from the start. **Does `get_email_analytics` work for all campaigns?** It works for any email that has been sent. You just need to specify which campaign you want metrics on when you ask your agent. **When I call `get_account_info`, what credentials does my AI client need to pass?** It requires your unique Buttondown API Key. Your agent passes this key during the initial setup, which authorizes all subsequent calls and ensures secure access to your core account settings. **If I run `list_subscribers`, how do I handle pagination or large lists of users?** The MCP handles pagination automatically. If you request a list larger than the limit, the agent returns an error code but also includes a 'next page token' in the response payload for continuous fetching. **Does `list_tags` provide only active tags or all historical tag definitions?** It lists every unique tag you have ever created. The output provides both the full tag name and a boolean flag, so your agent knows exactly which ones are currently active for use with `create_subscriber`. **When I get details using `get_subscriber`, can that data be cross-referenced against my tags?** Yes. The profile returned by the tool includes an array of all applied tags. Your agent processes this list to confirm exactly which metadata groups are attached to that specific user's record. **Can I check the open rate for a specific email using the agent?** Yes! Use the `get_email_analytics` tool with the Email ID. Your agent will fetch the detailed statistics, including deliveries, opens, and clicks, directly from Buttondown. **How do I add a new subscriber with a specific tag?** Simply ask the agent to `create_subscriber` and provide the email address and a JSON array of tags, for example: `["customer", "api-lead"]`. The subscriber will be added to Buttondown instantly. **Does the integration allow creating a new draft email?** Yes. Use the `create_email` action and set the status to `draft`. You can provide the subject and the body in markdown format, and it will appear in your Buttondown account ready for review.