Buttondown MCP. Manage lists, segment audiences, and draft campaigns.
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 handles your entire newsletter workflow. Use this connector to manage subscriber lists, draft campaigns, set up tags, and automate email operations directly from any AI agent.
What your AI agents can do
Create email
Create a new email
Create subscriber
Create a new subscriber
Create tag
Create a new tag
Create new users, update existing profile details, or delete accounts using specific identifiers.
Build organization structures by creating and listing custom tags to group subscribers for targeted campaigns.
Generate new email drafts and retrieve details of past or scheduled newsletters.
Retrieve the specific details of any newsletter campaign that has been sent or is set to publish.
Set up webhooks so Buttondown events trigger actions in your other tools and platforms.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Buttondown Alternative: 14 Tools Available
These tools let your agent perform every operation related to managing your subscribers, tags, campaigns, and webhooks.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Buttondown on Vinkius019e5d04create email
Create a new email
019e5d04create subscriber
Create a new subscriber
019e5d04create tag
Create a new tag
019e5d04create webhook
Create a new webhook
019e5d04delete subscriber
Delete a subscriber
019e5d04get email
Retrieve a specific email
019e5d04get newsletter
Retrieve a specific newsletter
019e5d04get subscriber
Retrieve a specific subscriber
019e5d04list emails
List all emails
019e5d04list newsletters
List all newsletters
019e5d04list subscribers
List all subscribers
019e5d04list tags
List all tags
019e5d04list webhooks
List all webhooks
019e5d04update subscriber
Update an existing subscriber
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,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ 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
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 14 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Managing mailing lists used to be a mess of tabs and spreadsheets.
Today, updating an audience list means logging into Buttondown, checking your spreadsheet for new sign-ups, manually applying tags one by one, and then drafting the email in another tool. It's copy-pasting IDs, switching between tabs, and hoping you don't miss a single person.
With this MCP, that whole sequence disappears. You tell your agent what to do—like 'segment everyone who signed up last month but hasn't opened an email.' The agent handles the list retrieval using `list_subscribers`, applies the required tags (`create_tag`), and then drafts a campaign ready for review.
The Buttondown MCP gives you full control over your mailing campaigns.
Instead of worrying about remembering which fields need updating, or if the email template is correct, your agent can validate and update records using `get_subscriber` before it even touches the draft. You don't just get a list; you get validated data ready for action.
The difference now isn't just convenience; it's reliability. You can automate complex flows—like ensuring that when a user is created, they are immediately tagged and added to a welcome sequence—all without writing boilerplate code.
What you can do with this MCP connector
You can build out complex audience logic without leaving your writing environment. This MCP lets you treat your mailing list like a database; you can pull specific groups of people, check their current status, or update them in bulk based on behavioral data.
Drafting and scheduling emails used to involve jumping between five different tools—the CMS, the spreadsheet, the tag manager, etc. Now, you just talk to your agent. Your agent handles checking existing subscriber details, grouping them by tags, drafting a new campaign using create_email, and even setting up webhooks so that data flows automatically to other systems.
It’s all running on Vinkius. Since every connection runs in its own sandbox with 34+ security rules enforced per call, you know your credentials are safe. Plus, through Vinkius AI Analytics, you get a clear history of exactly what your agent did—which tools were called and how the data moved.
You never lose visibility into your audience operations.
019e5d04-9cdb-7103-ab33-0c66cd39598f 
How Buttondown MCP Works
- 1 Subscribe to this MCP and provide your unique Buttondown API key.
- 2 Connect the service via any MCP-compatible client (like Cursor or VS Code).
- 3 Ask your agent to perform a task, such as 'list all subscribers with the tag marketing' to get results.
The bottom line is you tell your AI agent what needs doing in natural language, and it handles the API calls needed to make it happen.
Who Is Buttondown MCP For?
This MCP is for content creators and marketing ops staff who spend too much time jumping between a mailing platform and their IDE just to update a list or schedule an email. It’s for people whose job requires moving data from one system into another.
Uses the MCP to segment large user bases by tag, then drafts specific emails using the create_email tool and schedules them for later release.
Connects subscriber actions (like a sign-up) to internal workflows by managing webhooks, ensuring that when a new person is added via create_subscriber, it triggers an action in the CRM.
Integrates newsletter list management into a larger application backend, using tools like list_subscribers and get_subscriber to validate user data before deployment.
What Changes When You Connect
- Stop guessing who needs to hear from you. You can use
list_tagsand then target only those users when drafting content withcreate_email, ensuring hyper-specific messaging every time. - No more manual CSV imports. If a new user signs up, your agent can immediately call
get_subscriberfollowed byupdate_subscriberto apply necessary initial tags or metadata fields automatically. - Building complex automations is simple. By managing webhooks and using the MCP's inherent security protections, you connect Buttondown events directly into cross-platform workflows without ever having your keys sit on a disk.
- Always know what worked. You can use
list_newslettersto see every published campaign, making it easy to review performance metrics or check details viaget_newsletter. This visibility is critical for marketing reporting. - Efficiency matters when dealing with data. Your agent handles retrieving specific user records using
get_subscriber, giving you immediate access to accurate data without needing to search through large datasets.
Real-World Use Cases
The Annual Re-engagement Campaign
A Marketing Manager needs to run a campaign for users who haven't opened an email in six months. The agent first calls list_subscribers, filters the data, and then uses tags (via create_tag) to mark them as 'reengage'. Finally, it drafts the outreach using create_email.
Post-Purchase Onboarding Flow
A Product Manager wants a new subscriber to immediately receive a welcome email and be tagged 'onboarded'. The agent handles calling create_subscriber, then triggering the necessary tag creation (create_tag) and scheduling the first educational newsletter.
Data Integrity Check
A Dev Ops Engineer needs to confirm that a key user's details are correct before an integration goes live. They use get_subscriber on the ID, then validate the data against stored expectations using list_webhooks to ensure connectivity.
Bulk List Cleanup
The team needs to clean up old, defunct addresses. The agent first uses list_subscribers, identifies stale accounts, and then calls delete_subscriber on the full list of IDs for compliance.
The Tradeoffs
Manual Tagging
A team member exports a spreadsheet, manually updates user tags in Excel, and then has to re-upload it to Buttondown.
→
Use the MCP's capability to manage labels. Your agent calls list_tags to see available groups, then uses update_subscriber to apply multiple new tags simultaneously.
Drafting Emails Offline
Writing an email draft in a separate word processor and copying it over later, risking formatting errors or missing campaign details.
→
Let your agent handle the whole process. It calls create_email and drafts the content directly into Buttondown, ensuring proper scheduling and metadata capture.
Missing Data Updates
A user changes their job title but forgets to update it in the system of record.
→
Use your agent to check current data with get_subscriber, then execute an immediate update_subscriber call to keep all records current and accurate.
When It Fits, When It Doesn't
Use this MCP if your core problem revolves around audience segmentation, campaign scheduling, or list hygiene. If you need to move user data (like a profile change) from one platform into Buttondown's system of record, this is what you use. Don't rely on it for complex financial actions; if you are managing billing cycles, subscription payments, or tax records, that requires an entirely separate finance-oriented MCP. If your goal is just to view analytics without making any changes, while list_newsletters helps, you might find a dedicated reporting tool better suited than attempting to build reports purely through the API.
Common Questions About Buttondown MCP
How do I add new users to my list using the Buttondown MCP? +
You use the create_subscriber tool. You simply provide the necessary details (like email and name) to the agent, and it handles adding that user to your system.
Can I bulk update subscriber metadata? Use the Buttondown MCP. +
Yes. After running list_subscribers, you can use update_subscriber on a list of IDs to change multiple fields across many users at once, saving massive amounts of manual effort.
What if I need to run an email campaign for only 'premium' members? Buttondown MCP? +
You first call list_tags and confirm the tag exists. Then, your agent uses the tagging tools to filter the list and draft the targeted content using create_email.
How do I track data flow from a signup into my backend system? Buttondown MCP? +
You manage this with webhooks. Your agent can create a new webhook via create_webhook, linking a specific Buttondown event to your external tools, ensuring continuous synchronization.
How do I ensure data security when using the Buttondown MCP? +
The connection runs through Vinkius's zero-trust proxy, meaning your API keys are only used in transit and never stored on disk. Every action is logged into a cryptographically signed audit trail for full visibility.
What happens if I try to `update_subscriber` with an invalid or non-existent user ID? +
The MCP handles this by failing the specific tool call gracefully. Instead of crashing your agent, it returns a descriptive error code and message, letting you know exactly which record failed.
Are there rate limits when I run `list_subscribers` for a very large list? +
No. The MCP handles pagination automatically. If your subscriber base is massive, the agent requests and processes data in manageable batches to ensure performance.
Before running `create_tag`, how do I see all existing tags using `list_tags`? +
Running list_tags immediately returns a comprehensive list of every tag currently attached to your account. This lets you check the exact spelling and type before creating anything new.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.