# Buttondown MCP for AI Agents AI Agent Connect > Buttondown lets you manage your newsletter and subscriber lists directly through your AI agent. You can draft emails, organize tags, and handle audience growth without switching tabs. It connects your Buttondown account to your AI workflow, making it easy to update subscriber info or schedule campaigns using plain English. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_J0EAJkDtodLsodGyP7flAGlSu8Zi7ZZRLHajLiWV/ai-agent-connect - **Tags:** newsletter, subscribers, email-campaigns, audience-management, content-creation ## Description This Connector connects your Buttondown account to your AI agent so you can handle your entire newsletter operation through a single chat interface. Instead of jumping between browser tabs to manage different lists or manually tagging hundreds of people, you can just tell your agent what needs to happen. You can draft new campaign emails, schedule them for specific dates, and organize your audience into segments using tags. It handles the heavy lifting of subscriber management, like adding new people to your list or updating their metadata, while you focus on the actual content. If you're looking to scale your newsletter, this is a great way to keep your data organized. It's one of the many tools available in the Vinkius catalog that helps you bridge the gap between your writing space and your distribution platform. You can also manage webhooks to ensure your other tools stay in sync with your newsletter events. It turns a manual, multi-step process into a conversation. ## Tools ### create_tag Make a new category for your subscribers. This helps you segment your audience more effectively. ### create_email Start a new email draft from scratch. You can use this to begin a new campaign or announcement. ### create_subscriber Add a new person to your mailing list. This is how you grow your audience manually or via agent. ### create_webhook Set up a new connection for external events. Use this to send data to other apps automatically. ### delete_subscriber Remove a person from your mailing list permanently. This helps you keep your list clean and compliant. ### get_email Pull the specific details of a single email. Use this to check the content or ID of a past campaign. ### get_newsletter Fetch the specific details for one of your publications. This is useful for checking specific newsletter settings. ### get_subscriber Find a specific person's details in your list. This helps you check an individual's status quickly. ### list_emails See every email you've ever sent or drafted. Use this to get a bird's eye view of your past campaigns. ### list_newsletters View all your active publications. This lets you see which newsletters are currently running. ### list_subscribers Pull a full list of everyone on your mailing list. It's the fastest way to see your total audience size. ### list_tags See all the categories you've created for your audience. This helps you keep your segmentation organized. ### list_webhooks Check which external tools are connected to your account. Use this to verify your automation links. ### update_subscriber Change the information for an existing person on your list. This is perfect for updating user preferences. ## Prompt Examples **Prompt:** ``` I need to schedule a newsletter for next Tuesday at 10 AM called 'Summer Update'. ``` **Response:** ``` I've created a draft for your 'Summer Update' newsletter and scheduled it for next Tuesday at 10:00 AM. **Email Name:** Summer Update **Status:** Scheduled **Date:** Next Tuesday **Time:** 10:00 AM ``` **Prompt:** ``` Can you see who is currently on my 'VIP' tag? ``` **Response:** ``` I've pulled the list of subscribers with the 'VIP' tag. | Name | Email | | :--- | :--- | | Jane Doe | jane@example.com | | John Smith | john@work.com | *Note:* There are currently 2 subscribers in this segment. ``` **Prompt:** ``` Add 'marketing_lead' as a tag to the subscriber with email 'test@test.com'. ``` **Response:** ``` I've updated the subscriber 'test@test.com' and successfully added the 'marketing_lead' tag to their profile. ``` ## Capabilities ### Draft and schedule newsletter emails Create new email drafts and set specific publish dates using your AI agent. ### Create and update subscriber records Add new people to your mailing list or modify existing member details through chat. ### Organize audiences with custom tags Categorize your subscribers into different segments to target your communications. ### Retrieve newsletter and email details Pull information on your active publications and past campaigns instantly. ### Manage webhook connections for external tools Connect your newsletter events to other apps by managing webhooks through your agent. ### Delete subscribers from your mailing list Remove inactive or unwanted users from your list to keep your data clean. ## Use Cases ### Scheduling newsletters without the dashboard A content creator wants to schedule a newsletter but is tired of the Buttondown UI. They ask their agent to draft a 'Weekly Wrap-up' email and schedule it for Friday at 9 AM. The agent uses create_email to set it up. ### Bulk tagging new signups A marketing manager needs to tag 50 new signups as 'Premium'. Instead of clicking 50 times, they ask the agent to update all new subscribers with the 'Premium' tag using update_subscriber and create_tag. ### Checking subscriber status A developer wants to see if a specific user is subscribed. They ask the agent to check the status of a user ID. The agent uses get_subscriber to pull the data and report back. ### Getting a bird's eye view of publications A team needs to see all their active newsletters in one go. The manager asks the agent to list all newsletters. The agent uses list_newsletters to provide a clean summary of all publications. ## Benefits - Stop switching tabs between your editor and Buttondown by drafting and scheduling emails directly in your AI client. - Keep your audience organized with automated tagging using create_tag and list_tags to segment your users without manual entry. - Save time on manual data entry by using create_subscriber and update_subscriber to manage your mailing list via chat. - Maintain a clear view of your content history by instantly pulling your full list of emails and newsletters. - Sync your newsletter data with other apps automatically by managing webhooks using create_webhook and list_webhooks. - Clean up your mailing list faster by using delete_subscriber to remove inactive or unwanted users with a simple command. ## How It Works The bottom line is you get a hands-free way to manage your newsletter distribution and subscriber data. 1. Connect your Buttondown account by providing your API key. 2. Describe the newsletter task you want to complete to your AI agent. 3. Watch your agent perform the actions in Buttondown and confirm the results. ## Frequently Asked Questions **Can I use Buttondown MCP to write my newsletters?** Yes, you can use it to draft and schedule emails. Your agent can write the content based on your instructions and then use the tools to save that content as a new draft in your Buttondown account. **How does Buttondown MCP help with subscriber management?** It lets you manage your audience without clicking through menus. You can ask your agent to add new people, update their info, delete old records, or organize them into different tags using plain language. **Will Buttondown MCP automatically send my emails?** It can schedule them for you. You can tell your agent to create an email and set a specific publish date, and the Connector will handle that request within your Buttondown account. **Can I manage webhooks through the Buttondown MCP?** Yes, you can list and create webhooks. This makes it easy to connect your newsletter events to other tools in your tech stack without manual setup in the dashboard. **Is Buttondown MCP safe for my subscriber data?** This Connector acts as a bridge between your AI client and your Buttondown account. It only performs the actions you specifically ask for, like listing subscribers or creating tags, using your own API credentials. **Does Buttondown MCP work with Cursor or Claude?** Yes, it works with any MCP-compatible client. Once connected, you can manage your newsletters directly within Cursor, Claude, or any other supported interface. **Can I schedule a newsletter for a future date using the AI?** Yes. When using the `create_email` tool, you can provide an ISO 8601 timestamp in the `publish_date` field to schedule your email for later. **How do I add tags to a subscriber when creating them?** You can use the `create_subscriber` tool and pass an array of strings in the `tags` parameter to categorize the new subscriber immediately. **Is it possible to update the email address of an existing subscriber?** Yes, use the `update_subscriber` tool with the subscriber's unique ID and provide the new email address in the `email` field.