Supercharge your AI with Buttondown. Manage campaigns and subscribers via chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
Buttondown manages your entire newsletter pipeline directly through natural language. Use this MCP to list subscribers, track detailed email analytics, draft new campaigns, or add new contacts—all without opening a dashboard.
Your agent handles subscriber oversight, campaign creation, and performance monitoring for immediate marketing action.
What your AI can do
Create email
Generates brand new email campaigns or saves them as drafts for later review.
Create subscriber
Adds a specific person to your newsletter list, allowing you to set custom tags and metadata at the same time.
Get account info
Retrieves core settings details for your entire Buttondown account profile.
Get a full list of all your newsletter subscribers and pull up detailed profiles for specific contacts.
Draft new email campaigns, create drafts, or send out emails without leaving your chat window.
Retrieve detailed open and click rates for any past sent email to see how well it performed.
View all existing tags and ensure your subscriber base is properly segmented by category or metadata.
On the fly, add new subscribers to your list and assign them custom tags right from your agent's chat.
Ask an AI about this
Compatible AI Apps
OAuth 2.0 Compatible Gemini Waiting for input…
Buttondown: 10 Tools for Marketing Ops
Use these tools to interact with every core function of your Buttondown account, from listing contacts to retrieving campaign performance metrics.
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
Generates brand new email campaigns or saves them as drafts for later review.
Create Subscriber
Adds a specific person to your newsletter list, allowing you to set custom tags and...
Get Account Info
Retrieves core settings details for your entire Buttondown account profile.
Get Email Analytics
Provides detailed reports, like open rates and click rates, for one particular sent...
Get Email
Fetches the full content and metadata for a single, specific email campaign or draft.
Get Subscriber
Looks up and returns the complete profile details for one specific subscriber.
List Emails
Retrieves a list of all emails you've sent out, plus any drafts sitting in your workspace.
List Newsletters
Lists every newsletter account or campaign container set up within your Buttondown...
List Subscribers
Provides a comprehensive list of all current subscribers in the entire newsletter...
List Tags
Displays every available tag, helping you verify how your subscriber base is...
Connect to your AI in seconds. 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,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ 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 10 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Manual dashboard jumping eats your day.
Right now, running a simple campaign check means opening the Buttondown site, navigating to 'Analytics,' selecting the date range, finding the specific email from last quarter, and then manually pulling out the open rate percentage. Then you have to copy that number into a spreadsheet just so your boss can see it.
With this MCP, you just ask your agent: 'What was the open rate for the Q2 newsletter?' It handles the API call instantly and spits out the single metric you need. You don't touch a dashboard; you just talk to your system.
The `get_email_analytics` tool provides actionable performance data.
Instead of viewing raw numbers, the agent processes the metrics. It doesn't just say 'Open Rate 45%.' It tells you: 'Your open rate was 45%, which is strong, but your click-through rate dropped by 3% compared to last month.'
This changes how you plan campaigns. You aren't guessing; you know exactly where the content failed or succeeded, letting you focus on making real improvements next time.
What your AI can actually do with this
Need to run an email campaign but don't wanna spend hours clicking through dashboards? This MCP connects your AI client directly to your Buttondown account. You can manage the whole newsletter process using just conversation. Want to check how last week’s update performed? Just ask for the analytics. Need a new draft? Your agent can create it and even add subscribers with specific tags, keeping everything organized.
It's all about talking to your marketing stack instead of clicking through menus. When you connect this MCP via Vinkius, you get one place where your AI client handles subscriber lists, email drafts, and campaign performance metrics right in your workflow.
019d7566-7178-70ee-82c7-e96a0ac158e0 
Here's how it actually works
The bottom line is that it lets your AI client treat your entire newsletter platform like a set of functions you can call conversationally.
Subscribe to this MCP and enter your unique Buttondown API key.
Tell your AI client what you need—for example, 'Show me the analytics for the last weekly update.'
Your agent executes the request by communicating with your Buttondown account and returns the data directly.
Who is this actually for?
Anyone whose job involves sending bulk communications and tracking results. This MCP is for the content creator tired of copy-pasting subscriber counts, or the marketer who needs to pull specific performance data without logging into a separate web app.
Drafting new updates and checking how many subscribers are available for the next mailing.
Pulling performance metrics from past campaigns or segmenting the audience by tagging them after a specific action.
Handling subscriber list maintenance, adding new contacts, and ensuring all tags are applied correctly before a send date.
What Changes When You Connect
You can check out the performance of an email using get_email_analytics, getting open rates and click counts immediately without manual dashboard navigation. It's instant data access.
Need to add a new contact? Use create_subscriber right through your agent. You can assign custom tags and metadata while you write, keeping your list clean from the start.
Never struggle with drafts again. With list_emails and create_email, you can see everything sent or waiting, and generate a whole new draft in one prompt.
Before hitting send, run through the full subscriber roster using list_subscribers. It's fast, giving you immediate oversight on list health.
Understand your entire account structure by running list_newsletters and checking core settings with get_account_info. Everything is centralized here.
See it in action
Analyzing a poor campaign performance
The Marketing Manager asks their agent, 'Show me the analytics for last month's product launch email.' The agent calls get_email_analytics and immediately reports that the click rate was only 5%, pointing out exactly which part of the email needs fixing.
Onboarding a new client list
The Ops Specialist runs into an unsorted batch of contacts. They prompt their agent to 'Add these 20 people and tag them as VIP.' The agent uses create_subscriber twenty times, ensuring every single person gets the correct metadata.
Creating a quick follow-up update
The Content Creator realizes they need to send an ad hoc announcement. They prompt their agent: 'Draft a new email with subject X and body Y.' The agent uses create_email, generating the content immediately for review.
Verifying segmentation rules
The Digital Marketing Manager needs to know if they have a tag called 'Beta Tester' before launching. They ask, and the agent uses list_tags to confirm its existence, preventing an entire campaign from failing due to bad data.
The honest tradeoffs
Treating it like a simple contact list.
Just asking for 'all subscribers' and expecting the agent to write marketing copy. It gives you raw data, not strategy.
First, use list_subscribers to get the names. Then, follow up by asking the agent: 'Now that I have this list, draft a compelling subject line for them.'
Forgetting to check your tags first.
Trying to segment an audience based on a tag like 'High Value' when you actually used the wrong name ('HV').
Always start by calling list_tags. This confirms exactly what labels exist in your system before you try to filter or use them.
Skipping draft creation.
Writing an email copy and then having to manually log into Buttondown just to save it for later review.
Use create_email first. This saves the content as a proper draft in your account, ready for scheduling.
When It Fits, When It Doesn't
You use this MCP if your primary goal is conversational control over campaign mechanics and data retrieval. You need to know who you're talking to (list_subscribers), what they saw (get_email_analytics), and how to reach them (create_email). Don't use it if you just want to manage your billing or user accounts—for that, check the core settings using get_account_info. If you only need to read a single email without worrying about performance stats, get_email is sufficient. But if you plan on any actual marketing workflow, this MCP covers all 10 tools and gives you full visibility.
Questions you might have
How do I use `list_subscribers` with this MCP? +
You prompt your agent to 'List all subscribers.' The MCP calls the tool and returns a clean list of every person currently signed up in Buttondown.
What's the difference between `get_email` and `list_emails`? +
list_emails gives you an index—a table showing titles and dates for all your campaigns. get_email lets you dive deep into one specific email to read its full content.
Can I use `create_subscriber` without knowing their tags? +
No, the tool is best used when you know the tags. You should prompt your agent: 'Add John Doe and tag him as Prospect.' This makes sure the data is clean from the start.
Does `get_email_analytics` work for all campaigns? +
It works for any email that has been sent. You just need to specify which campaign you want metrics on when you ask your agent.
When I call `get_account_info`, what credentials does my AI client need to pass? +
It requires your unique Buttondown API Key. Your agent passes this key during the initial setup, which authorizes all subsequent calls and ensures secure access to your core account settings.
If I run `list_subscribers`, how do I handle pagination or large lists of users? +
The MCP handles pagination automatically. If you request a list larger than the limit, the agent returns an error code but also includes a 'next page token' in the response payload for continuous fetching.
Does `list_tags` provide only active tags or all historical tag definitions? +
It lists every unique tag you have ever created. The output provides both the full tag name and a boolean flag, so your agent knows exactly which ones are currently active for use with create_subscriber.
When I get details using `get_subscriber`, can that data be cross-referenced against my tags? +
Yes. The profile returned by the tool includes an array of all applied tags. Your agent processes this list to confirm exactly which metadata groups are attached to that specific user's record.
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.
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 10 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.