Buttondown MCP for AI. Manage lists, tags, and campaigns via conversation.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
Buttondown lets you manage your entire newsletter and subscriber base directly from any AI agent. You can draft new emails, update subscriber tags, pull lists of contacts, and even set up webhooks—all using natural conversation.
It's the single connection point for all your audience growth tasks.
What your AI can do
Create email
Writes and saves a brand-new email draft within your Buttondown account.
Create subscriber
Adds a completely new contact to your subscriber list.
Create tag
Generates and saves a new organizational tag for later use on subscribers or campaigns.
You can list, create, update, or delete individual subscribers by their email address.
The tool lets you write new email campaigns and set specific dates for them to go live.
You can create, list, and assign descriptive tags to subscribers so your audience is properly segmented.
The MCP lets you get specific data about past or scheduled newsletters and email drafts.
You can manage webhooks to trigger Buttondown events in your internal tools or other services.
Ask an AI about this
Waiting for input…
Buttondown Alternative: 14 Tools for Email Operations
These tools let you perform every major action in email marketing—from creating a single tag to listing all webhooks—all through simple commands.
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 VinkiusCreate Email
Writes and saves a brand-new email draft within your Buttondown account.
Create Subscriber
Adds a completely new contact to your subscriber list.
Create Tag
Generates and saves a new organizational tag for later use on subscribers or...
Create Webhook
Sets up an automatic alert that triggers when specific Buttondown events occur.
Delete Subscriber
Permanently removes a subscriber record from your list.
Get Email
Retrieves the full details of a specific email draft or sent campaign.
Get Newsletter
Pulls all the published and scheduled data for one particular newsletter publication.
Get Subscriber
Fetches the full profile details for a single subscriber by their email address.
List Emails
Provides a list of all emails, both drafts and previously sent ones.
List Newsletters
Returns an overview and list of every newsletter you've created or scheduled.
List Subscribers
Generates a complete, actionable list of all contacts currently in your system.
List Tags
Shows you every tag name that is currently available for use on your audience.
List Webhooks
Lists all active webhooks and their current configurations.
Update Subscriber
Modifies existing contact data, like changing a tag or adding new metadata.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token
from cloud.vinkius.com. For OAuth-protected servers, expand
Advanced settings to add credentials.
Start a conversation
Open a new chat. The Buttondown integration is available immediately — no restart needed.
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 5,100+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,100+ 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 connection provides 14 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Keeping track of who signed up and what they're interested in is a mess.
Right now, you know how it is. A new batch of signups rolls in. You have to jump into the platform, manually check tags, see if they belong to one segment or three. Then, you copy that list out and paste it somewhere else just so your team can start working on a campaign draft.
With this MCP connection, all that friction disappears. You tell your agent, 'Give me everyone in this list who is marked as both 'Beta Tester' and hasn't opened an email since last month.' The agent instantly handles the complex filtering, giving you a clean, actionable audience list—ready to use.
Buttondown MCP: Effortlessly Manage Your Campaign Drafts
You used to have to write your copy in one place, export it, open a separate document to get approval sign-off, and then manually paste the final version into Buttondown. That's three different systems just for one email.
Now, you simply ask your agent to 'Draft a follow-up email about our new widget.' The MCP handles the creation of that draft using `create_email` directly in your chat window. It saves you from jumping between tabs and keeps your focus where it belongs: on writing.
What your AI can actually do with this
Think of this MCP as giving your AI client a direct line into your entire email marketing system. You no longer have to switch tabs or jump between different dashboards just to manage contacts. Instead, you talk to your agent and tell it exactly what you need done—whether that's listing every subscriber who hasn't opened an email in three months, or drafting a new campaign based on specific tags.
It handles the heavy lifting: creating records for brand-new subscribers, adjusting existing ones, and even building out complex webhooks to talk to your other tools. Since it’s hosted on Vinkius, you connect once from any compatible client, giving your agent access to thousands of services—and Buttondown is just one of them.
This means you keep everything in one place: conversationally managing your audience and content without ever leaving your writing environment.
019e5d04-9cdb-7103-ab33-0c66cd39598f 
Here's how it actually works
The bottom line is that you talk to your AI client like talking to a coworker who already knows how to use Buttondown.
First, subscribe to this MCP and provide your unique Buttondown API key.
Next, you use a simple prompt with any AI client, telling it the task (e.g., 'List all subscribers tagged as VIP').
Finally, your agent calls the necessary tools, retrieves the requested data, and presents it back to you in plain text.
Who is this actually for?
Marketing Operations Managers and Content Creators. You're the person whose job involves constant list cleaning, segmentation, and drafting campaign ideas—the kind of work that requires jumping between a spreadsheet, an email client, and a CRM every hour. This MCP cuts out all those clicks.
Runs bulk operations like adding new tags to thousands of subscribers or ensuring webhooks are set up correctly after a major campaign launch.
Drafts and schedules entire newsletters without leaving their writing app, then asks the agent to retrieve old campaigns for reference.
Manages subscriber onboarding by creating new records or updating metadata based on user actions tracked elsewhere.
What Changes When You Connect
Avoid manual data dumps. Instead of exporting a CSV just to find out who hasn't opened an email, you ask your agent to list subscribers and filter by activity.
Keep content flowing without context switching. Draft emails or schedule entire newsletters using the create_email tool directly within your AI chat, keeping your focus on writing.
Improve segmentation accuracy. You can use the agent to create new tags and then update thousands of records at once via update_subscriber, making targeting precise.
Simplify troubleshooting. Need to know why a workflow broke? Use list_webhooks to check all existing connections without logging into another service.
Maintain an accurate history. Quickly get the details for any past campaign using get_newsletter or get_email instead of searching through archives.
See it in action
Cleaning up stale contacts
A marketer needs to wipe out subscribers who haven't engaged in a year. They ask their agent to 'List all subscribers who have no activity since 2023.' The agent calls list_subscribers and filters the results, allowing the user to then delete them using the appropriate tool.
Launching a new product line
A team needs to launch an email sequence for premium users. They tell their AI client, 'Create a new tag called Premium Launch' and assign it to all current subscribers.' The agent handles both the create_tag and multiple update_subscriber calls instantly.
Revising old content
A copywriter finds an old newsletter (get_newsletter) that needs a major update. They ask their agent to fetch its details, then draft new copy using the create_email tool with updated information.
Connecting internal systems
The developer wants to notify an internal database every time someone signs up. Instead of writing complex API code, they use the agent to set up a new webhook (create_webhook) that points to their endpoint.
The honest tradeoffs
Trying to manage data piece by piece
Opening Buttondown, clicking 'Subscribers,' finding one person, copying their tag name, switching to Google Sheets, and then going back to add the tag.
Don't manually click through. Just tell your agent: 'Find all subscribers who are not yet tagged as VIP.' The agent uses list_subscribers and filters everything in one step, saving you the manual work.
Forgetting to update records
Manually adding a new segment of users to your list but forgetting to apply the correct tag or metadata to them.
After importing a group of people, tell your agent: 'Take these 200 new contacts and assign them the 'Onboarding' tag.' The tool handles the mass update_subscriber action.
Not knowing what data exists
Assuming you can send an email draft without first checking if the specific campaign ID is valid or if a better version exists.
Always check first. Use list_newsletters to see all published content, then use get_newsletter to retrieve the exact details before attempting to modify it.
When It Fits, When It Doesn't
Use this MCP if your primary need is manipulating audience records and drafting email campaigns using Buttondown's existing infrastructure. This is for managing who gets what message and when. Don't use it if you are trying to build a totally new data source (like collecting user behavior from a custom website) or if you need complex financial transaction logging; those require tools focused on webhooks or external CRM integration, not just audience management. If your goal is purely internal reporting without sending anything, look for general database read tools instead.
Questions you might have
How do I use create_subscriber with Buttondown? +
You ask the agent to 'Create a new subscriber for john@example.com.' The MCP handles the API call, adding them directly to your list without you touching any web UI.
Can I update_subscriber tags in bulk? +
Yes. You can instruct the agent to run an update_subscriber tool command on a specific group of users or apply a tag across multiple contacts at once.
What is list_webhooks used for? +
The list_webhooks tool shows you every connection point. You can use this to verify that your external systems are correctly receiving data when an event happens in Buttondown.
Does get_subscriber give me all metadata? +
Yes, the get_subscriber function retrieves a full profile of the person. You'll see their activity history and all assigned tags right there.
Before I use tools like `list_subscribers` or `get_newsletter`, how do I ensure my authentication is set up correctly? +
Authentication requires your Buttondown API Key. Make sure this key has the necessary read and write permissions for all functions you plan to run. If the credentials are wrong, the agent will immediately fail with an authorization error.
If I use `list_emails` or `list_tags` repeatedly in a short timeframe, is there any rate limiting I need to worry about? +
Yes. The API enforces standard rate limits on bulk requests. If your agent hits this limit, it will fail until you wait for the reset period. You'll need to implement backoff logic into your calling workflow.
When I use `create_email`, what are the absolute mandatory fields required for a successful draft creation? +
You must provide a subject line and body content. The API validates these two basic parameters; if either is missing, the call will fail immediately and return an error code detailing the specific parameter that's needed.
What happens if I run `delete_subscriber` using a subscriber ID that doesn't exist in Buttondown? +
The system returns a clear 404 Not Found error. Your agent should be set up to catch this specific HTTP code, allowing it to log the failure and continue processing the rest of your list without crashing.
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.
We've already built the connector for Buttondown. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 14 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.