How to Use the Buttondown MCP in Mastra AI

Build resilient email automation workflows using Mastra AI to manage your Buttondown newsletters.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Buttondown MCP to Mastra AI

Create your Vinkius account to connect Buttondown to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Buttondown with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Self-healing subscriber onboarding

The `create_subscriber` tool integrates into Mastra AI workflows via MCP to add readers and automatically retry if the API rate limit hits. If a signup fails, Mastra's built-in engine uses exponential backoff to ensure the reader gets added. You can set up conditional branches that run `list_tags` to categorize the new subscriber. If the tagging step fails, Mastra routes the failure to an admin alert while keeping the subscriber record intact.

Draft newsletters via MCP Server

This MCP Server provides the `create_email` tool to let Mastra agents generate draft campaigns based on external triggers. When a new blog post goes live, the agent builds the newsletter draft automatically. Before finalizing, the workflow uses `list_newsletters` to confirm it targets the correct audience segment. You can require manual approval in Mastra before the draft moves to a sent state.

Programmatic campaign cleanup

The `get_email_analytics` tool allows Mastra agents to monitor campaign performance and trigger follow-up tasks based on reader engagement. If open rates drop below a specific threshold, the agent branches to a different strategy. It can run `list_subscribers` to identify inactive readers and tag them for a re-engagement campaign. The entire loop runs in the background without manual oversight.

Setup guide

Set up Buttondown MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Buttondown tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "buttondown-mcp-client",
  servers: {
    "buttondown-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Buttondown Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Buttondown tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Buttondown transactions"
);
console.log(result.text);

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Buttondown now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Buttondown MCP in Mastra AI

Initialize the client using new MCPClient with your Vinkius URL. Then, call listTools() and spread the resulting Buttondown tools directly into your agent's tool array.

Yes. You can configure Mastra's workflow engine to halt after calling create_email and wait for manual confirmation before the agent proceeds with any other actions.

Mastra uses a workflow engine that monitors the HTTP transport. If a call to list_subscribers fails due to a network glitch, it triggers automatic retries.

Mastra automatically detects the transport type. Since Vinkius hosts the server, it connects over a secure HTTP or SSE endpoint with zero local configuration.

Your API tokens and subscriber emails are processed entirely in memory within an ephemeral sandbox. No data is written to disk, keeping your newsletter list isolated from external storage.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript