Buttondown MCP. Manage campaigns and subscriber data from your chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Buttondown MCP Server manages your entire newsletter workflow. You can list all subscribers, retrieve detailed profiles, and add new contacts with custom tags.
It lets you create drafts, manage sent emails, and pull specific analytics (open/click rates) directly from your AI agent. It's full control over your email list and campaigns, without leaving your chat interface.
What your AI agents can do
Create email
Makes a new email draft or campaign.
Create subscriber
Adds a new contact to your newsletter list.
Get account info
Retrieves core account settings and profile details.
Get open and click rates for any specific email campaign.
List all current subscribers or pull detailed profiles for individual users, including tags.
Create new email drafts or entire campaigns from the chat interface.
List all available tags to ensure your audience is properly categorized before sending.
Add new subscribers directly to your list, assigning them custom metadata or tags.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Buttondown MCP Server: 10 Tools for Email & Subscriber Ops
These tools let your AI agent manage everything from list creation and tag management to drafting and analyzing email campaigns.
019d7566create email
Makes a new email draft or campaign.
019d7566create subscriber
Adds a new contact to your newsletter list.
019d7566get account info
Retrieves core account settings and profile details.
019d7566get email
Gets the full details of a specific email campaign or draft.
019d7566get email analytics
Pulls open and click rate data for a specific sent email.
019d7566get subscriber
Gets the detailed profile for a single subscriber.
019d7566list emails
Lists all emails, both sent and drafted.
019d7566list newsletters
Lists every newsletter managed in your Buttondown account.
019d7566list subscribers
Lists every current subscriber in the newsletter.
019d7566list tags
Lists all the segmentation tags available for your subscribers.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Buttondown, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Buttondown MCP Server handles your whole newsletter operation. You'll manage everything from checking subscriber lists to pulling campaign analytics, all through your AI agent. You don't have to leave the chat to run complex stuff.
How Buttondown MCP Works
- 1 Subscribe to the server and pass your Buttondown API Key.
- 2 Ask your AI agent to execute a marketing task (e.g., 'List all subscribers in the 'VIP' tag').
- 3 The agent uses the correct tool, fetches the data, and reports the full results back to you in the chat.
The bottom line is you manage your entire newsletter stack through conversation, eliminating the need to jump between tabs.
Who Is Buttondown MCP For?
This is for content creators and marketers who spend too much time jumping between the Buttondown dashboard, Google Sheets, and email clients. If you're tired of manual copy-pasting of analytics or having to check 10 different tabs just to figure out campaign performance, this is for you. It puts your entire audience management system right where you are working.
Draft new updates and check subscriber counts without leaving their writing tool.
Retrieve email performance metrics (open/click rates) and manage audience tags straight from their workflow tools.
Integrate newsletter subscription and campaign steps into a larger system using natural language calls.
What Changes When You Connect
- See who's in your audience with
list_subscribersandlist_tags. You get a full view of your list segmentation without opening the dashboard. - Track performance instantly. Instead of digging into a separate analytics tab, simply ask the agent to run
get_email_analyticsfor any campaign. - Build campaigns on the fly. Use
create_emailto draft a new newsletter orlist_newslettersto check existing drafts, all in natural conversation. - Handle list growth immediately. When you capture a lead, use
create_subscriberto add them right away, including custom tags and metadata. - Understand account health. Run
get_account_infoto check core profile settings without navigating away from your workspace.
Real-World Use Cases
Checking Performance After Launch
A marketing manager needs to know the open rate for the 'Q3 Product Update' email. Instead of logging into the dashboard and navigating to the analytics section, they simply prompt their agent: 'Show analytics for the Q3 Product Update.' The agent runs get_email_analytics and reports the 45% open rate and 12% click rate immediately.
Onboarding a New Lead
A content creator meets a promising lead at a conference. They need to add the person to the list immediately. They ask the agent to add the contact, specifying the tags: 'Conference Lead' and 'Finance Interest.' The agent uses create_subscriber to add the person with the right tags and metadata.
Segmenting for a Pitch
A copywriter needs to write an email only for high-value contacts. They first ask the agent to run list_tags to confirm the 'High Value' tag exists. Then, they ask to list_subscribers filtered by that tag, getting a clean list to draft the targeted content.
Debugging a Campaign
The email manager notices a campaign seems off. They run list_emails to see all sent and drafted campaigns, then use get_email on the specific ID to check the subject line and body before scheduling a fix.
The Tradeoffs
Manual Dashboard Diving
Logging into the Buttondown site, clicking the 'Subscribers' tab, then filtering by 'Active' status, and finally copying the list to a spreadsheet. This takes 5-10 minutes.
→
Just ask your agent to 'List all active subscribers' using list_subscribers. You get the required data list instantly in the chat without clicking anything.
Forgetting Tags
Adding a new subscriber but forgetting to assign a relevant tag (e.g., 'Industry: SaaS'). The data becomes unusable later when trying to segment.
→
Not checking drafts first
Trying to edit an email that was recently deleted or renamed, resulting in an error and a wasted minute of troubleshooting.
→
Over-complicating the request
Instead of asking for simple analytics, trying to write a complex SQL query to figure out open rates. This requires specialized knowledge and multiple steps.
→
When It Fits, When It Doesn't
Use this server if your job involves regular, repeated data queries across different parts of your newsletter platform—like checking subscriber counts, analyzing open rates, and drafting new content—and you want to do it all in one chat window. You need to run get_email_analytics and list_subscribers frequently. Don't use this if your only task is to set up the API connection once and never touch the data again. If you only need to view a single piece of static data (like just the API Key), there's no need. This tool is for active, conversational data manipulation.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Buttondown. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Checking your newsletter stats usually means juggling 4 different tabs.
Today, checking your campaign performance is a slog. You have to log into the Buttondown dashboard, find the 'Analytics' section, select the correct email, and then copy the open rate and click rate into your report. If you need to check five emails, you repeat that whole process five times. It’s slow and error-prone.
With the Buttondown MCP Server, you just ask your agent: 'What was the open rate for the Q3 campaign?' It runs the `get_email_analytics` tool and hands you the number in plain text. The data comes right here, where you're already working.
Buttondown MCP Server: Manage subscribers, emails & analytics
Forget manually listing tags or checking individual user profiles. You can now run `list_tags` to see your current segments, then ask the agent to `list_subscribers` using a specific tag. All the data flow happens in the background, and you just get the clean list you need.
The difference is that you don't write code or click through a GUI. You speak to your agent, and it handles the API calls to get the data and put it in context for you.
Common Questions About Buttondown MCP
How do I use the `get_email_analytics` tool? +
You ask your agent to get the analytics for a specific email. You must provide the email ID or campaign name. The agent executes the tool and returns the open and click rates for you.
Can I add new users with the `create_subscriber` tool? +
Yes. The create_subscriber tool lets you add new contacts. You can include custom metadata or tags when you call it, ensuring the user is properly categorized from day one.
What does `list_subscribers` do? +
list_subscribers fetches a comprehensive list of all people in your newsletter. You can then ask for details on specific people using the get_subscriber tool.
How do I see all my available tags? +
Run the list_tags tool. This shows you every segmentation tag currently used in your Buttondown account, helping you keep your audience organized.
Can I create a draft email using `create_email`? +
Yes. create_email lets you make a brand new draft or campaign. You just need to provide the subject and body content, and the draft is created in your Buttondown account.
What information does `get_subscriber` provide about a specific user? +
It returns a detailed profile for the subscriber. You'll get their full metadata, tags, and basic account information.
How do I list all the newsletters using `list_newsletters`? +
Calling list_newsletters provides a list of every newsletter managed in your account. This lets you know which campaigns you can work on.
Is there a way to see all my sent and drafted emails using `list_emails`? +
Yes, list_emails pulls a comprehensive list of everything. You can see both emails that have been sent out and drafts you've created.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Mention
Monitor brand mentions across the web, social media, and news in real time to protect your reputation and spot trends early.
emfluence Marketing
Equip your AI agent to manage marketing emails, track contact groups, and monitor performance via the emfluence API.
Buffer
Plan, schedule, and publish social media content across all your channels with analytics that show what is working.
You might also like
MotionTools
Manage logistics and delivery operations via MotionTools — track bookings, drivers, and vehicles directly from your AI agent.
Freshworks
Manage unified CRM and support via Freshworks — track sales deals and accounts, handle helpdesk tickets, and manage contacts directly from any AI agent.
Payrexx
Accept payments online with a Swiss payment gateway that supports local and international methods with PCI compliance built in.