How to Use the Buttondown MCP in Vercel AI SDK

Q: Can I use Vercel AI SDK to filter Buttondown subscribers by tag?

Yes. Your agent can call listtags to find active segments and then use listsubscribers to filter the audience. The SDK streams the filtered list straight to your frontend components.

Let your users watch their Buttondown subscriber lists and drafts update in real time with Vercel AI SDK.

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 Vercel AI SDK

Create your Vinkius account to connect Buttondown to Vercel AI SDK 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 Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live-updating subscriber dashboards

The `list_subscribers` tool lets your Vercel AI SDK app pull active readers through the MCP connection. We skip the loading spinners here. Your AI client fetches the list and streams the raw JSON right into your React components as it arrives. If a user wants to clean up their audience, your agent invokes `get_subscriber` to check active status. It updates the UI card live, giving your users immediate feedback without page refreshes.

Draft campaigns via MCP Server

This MCP Server exposes the `create_email` tool so your AI client can draft newsletters directly inside your Next.js preview window. Your users describe what they want to write, and the AI builds the draft live on screen. By pairing this with `list_tags`, the SDK lets the agent tag the draft for specific segments. The draft appears in the user's workspace instantly, ready for a final manual check.

Real-time analytics streaming

The `get_email_analytics` tool feeds open rates and click data directly into your streaming UI. Instead of waiting for a heavy API payload, the Vercel AI SDK handles the stream so numbers tick up on the screen in real-time. Your agent can analyze these metrics on the fly, comparing them against previous sent campaigns retrieved via `list_emails`. It gives your users an immediate, interactive breakdown of their newsletter performance.

Setup guide

Set up Buttondown MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Buttondown tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Buttondown transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

Wrap your createMCPClient call in a standard try-catch block. If the Buttondown API rate-limits your request, the SDK will catch the error, allowing you to close the connection gracefully using mcpClient.close().

Yes. Your agent can call list_tags to find active segments and then use list_subscribers to filter the audience. The SDK streams the filtered list straight to your frontend components.

No. Vinkius manages the MCP authentication layer. You just pass your single Vinkius endpoint token into the createMCPClient transport URL, keeping your Buttondown credentials secure.

Yes. The Buttondown integration uses lightweight HTTP transport, making it fully compatible with Edge environments without adding cold-start overhead.

Your subscriber emails and draft content never persist on Vinkius. The server runs in an ephemeral V8 sandbox, routing requests directly between your Vercel deployment and Buttondown's API with zero permanent 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