# Buttondown MCP for AI Agents AI Agent Connect > Buttondown MCP lets you manage your entire newsletter operation from your AI agent. You can pull subscriber lists, draft new emails, and check your open rates without ever leaving your workspace. It turns your AI into a dedicated marketing assistant for your email list. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_H5jp49jxICVvescG3JJa5NtO5fbjsEAjNsBlEVOq/ai-agent-connect - **Tags:** email-marketing, newsletter, subscriber-management, analytics, campaign-management ## Description The Buttondown MCP connects your newsletter account to your AI agent so you can manage your entire email operation through natural conversation. Instead of switching tabs to check open rates or manually copying subscriber data, you can just ask your agent to do the heavy lifting. This Connector lets you pull subscriber lists, create new drafts, and track performance metrics without ever leaving your workspace. You can have your agent pull specific profiles, organize your audience with tags, and add new signups with custom metadata on the fly. It takes the friction out of newsletter management by putting your marketing data right where you're already working. Whether you're checking your growth or prepping a big blast, you can do it all without the dashboard hop. Vinkius makes it easy to get this set up so you can stop jumping between tools and start focusing on your content. You can get a clear picture of your audience's behavior and respond to their needs faster than ever before. You'll spend less time on admin and more time on the actual writing that matters. ## Tools ### create_subscriber Use create_subscriber to add a new person to your newsletter list. It lets you include custom metadata and tags right away. ### create_email Use create_email to create a new email or a draft in your account. You can set the subject and body through your AI. ### get_account_info Use get_account_info to pull your core profile and account settings. Use this to check your current account status. ### get_email_analytics Use get_email_analytics to see how many people opened or clicked a specific email. This helps you track campaign success instantly. ### list_emails Use list_emails to see a full list of your sent emails and drafts. This makes it easy to find past work quickly. ### list_subscribers Use list_subscribers to get a full list of everyone on your newsletter. This is your go-to for checking total reach. ### list_tags Use list_tags to see all the tags you've created for your audience. Use this to understand how your segments are organized. ### get_email Use get_email to pull the full details of a specific email. Use this to review past content or check draft status. ### get_subscriber Use get_subscriber to get the profile details for a single subscriber. It's the fastest way to see a specific person's info. ### list_newsletters Use list_newsletters to see every newsletter in your account. This gives you a bird's-eye view of all your active projects. ## Prompt Examples **Prompt:** ``` How many people opened my last newsletter? ``` **Response:** ``` I've pulled the analytics for your most recent emails. Here is the performance summary: | Email Subject | Open Rate | Click Rate | Recipients | | :--- | :--- | :--- | :--- | | Weekly Update #42 | 45% | 12% | 150 | | Summer Sale Blast | 38% | 15% | 142 | | Welcome Series | 62% | 8% | 85 | Would you like me to pull the specific click data for any of these? ``` **Prompt:** ``` Who are my newest subscribers? ``` **Response:** ``` Here are the 5 most recent subscribers who joined your list: * **john.doe@example.com** (Tag: VIP) * **jane.smith@example.com** (Tag: Early Adopter) * **alex.w@provider.net** (Tag: Newsletter) * **sam.t@domain.com** (Tag: VIP) * **li.w@webmail.com** (Tag: Newsletter) I can pull more details for any of these users if you need them. ``` **Prompt:** ``` Draft a 'Welcome' email for new signups. ``` **Response:** ``` I've created a new draft in your Buttondown account: **Draft Details:** * **Subject:** Welcome to the community! * **Body:** Hi there, thanks for joining our newsletter. We're excited to have you here. You'll receive weekly updates on our latest projects and exclusive content. **Status:** Saved as a draft. Would you like me to make any edits to the text? ``` ## Capabilities ### Pull subscriber lists Get a full list of everyone on your newsletter and their specific details. ### Create new email drafts Generate new email content or drafts directly in your account via your AI. ### Check email performance See exactly how many people opened or clicked your recent campaigns. ### Add new subscribers Add new people to your list with custom tags and metadata instantly. ### Manage audience tags View and organize your subscriber segments to keep your audience categorized. ### View account settings Access your core profile and account information through your agent. ## Use Cases ### Checking growth stats A writer asks for the total subscriber count and the names of the last 5 people who joined to see if their latest post worked. ### Performance review A marketer wants to know the click rate of last week's 'Summer Sale' email to decide if they should pivot their strategy. ### Quick content drafting A creator tells the AI to 'Make a draft for a Welcome email' and then asks it to list all current newsletters to see which one to add it to. ### Audience cleanup A manager wants to see all tags to see if they have a VIP segment and then asks to add a new subscriber with that specific tag. ## Benefits - Stop switching tabs by using list_emails to find past content while you're still in your writing app. - Get instant feedback on your reach using get_email_analytics to see what's actually resonating with your audience. - Organize your audience better by using list_tags to see how your segments are currently grouped. - Speed up your growth by using create_subscriber to add new signups without leaving your current workspace. - Draft content faster by using create_email to turn your ideas into ready-to-send newsletters in seconds. ## How It Works The bottom line is you get a direct line of communication between your AI and your newsletter data. 1. Subscribe to the Buttondown MCP on Vinkius. 2. Paste your Buttondown API key into your AI client's configuration. 3. Ask your agent to draft an email, pull subscriber stats, or check your latest analytics. ## Frequently Asked Questions **Can I use the Buttondown MCP to see my open rates?** Yes, you can pull analytics for any specific email to see how many people opened or clicked your content. This helps you understand what your audience actually likes. **How do I add new subscribers with the Buttondown MCP?** You can just ask your agent to add a person to your list. It will handle the connection to Buttondown and add them with any tags or metadata you specify. **Does the Buttondown MCP work with Cursor?** Yes, it works with any MCP-compatible client, including Cursor, Claude, and Windsurf. You just need to connect your Buttondown API key. **Can I manage different newsletters with the Buttondown MCP?** Yes, you can list all the newsletters in your account and manage drafts or subscribers for any of them through your AI agent. **Can I see my audience tags using the Buttondown MCP?** Yes, the Connector lets you list all your existing subscriber tags so you can keep your audience segments organized and accurate. **Is the Buttondown MCP good for tracking growth?** It's a great way to track growth because you can quickly pull subscriber lists and see new signups without having to log into a separate dashboard. **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.