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.

Buttondown MCP Server for LangChain 10 tools — connect in under 2 minutes

Name: Buttondown
Availability: InStock
Author: Vinkius

python.langchain.com/docs/integrations/tools/mcp

Built by Vinkius GDPR 10 Tools Framework

LangChain is the leading Python framework for composable LLM applications. Connect Buttondown through Vinkius and LangChain agents can call every tool natively. combine them with retrievers, memory, and output parsers for sophisticated AI pipelines.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

import asyncio
from langchain_mcp_adapters.client import MultiServerMCPClient
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    async with MultiServerMCPClient({
        "buttondown": {
            "transport": "streamable_http",
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
        }
    }) as client:
        tools = client.get_tools()
        agent = create_react_agent(
            ChatOpenAI(model="gpt-4o"),
            tools,
        )
        response = await agent.ainvoke({
            "messages": [{
                "role": "user",
                "content": "Using Buttondown, show me what tools are available.",
            }]
        })
        print(response["messages"][-1].content)

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Buttondown MCP Server

Connect your Buttondown account to any AI agent and orchestrate your newsletter, subscriber management, and email campaigns through natural conversation.

LangChain's ecosystem of 500+ components combines seamlessly with Buttondown through native MCP adapters. Connect 10 tools via Vinkius and use ReAct agents, Plan-and-Execute strategies, or custom agent architectures. with LangSmith tracing giving full visibility into every tool call, latency, and token cost.

What you can do

Subscriber Oversight — List all your subscribers and retrieve detailed profiles, including metadata and tags.
Email Management — List all sent emails and drafts, and create new campaigns or drafts directly from your workspace.
Analytics Tracking — Retrieve detailed analytics for specific emails, including open and click rates.
Segment Coordination — Access and list your tags to ensure your audience is properly categorized.
Newsletter Access — List all newsletters managed in your account and access your core profile settings.
Subscriber Growth — Add new subscribers directly from your workspace with custom tags and metadata.

The Buttondown MCP Server exposes 10 tools through the Vinkius. Connect it to LangChain in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect Buttondown to LangChain via MCP

Follow these steps to integrate the Buttondown MCP Server with LangChain.

Install dependencies

Run pip install langchain langchain-mcp-adapters langgraph langchain-openai

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token

Run the agent

Save the code and run python agent.py

Explore tools

The agent discovers 10 tools from Buttondown via MCP

Why Use LangChain with the Buttondown MCP Server

LangChain provides unique advantages when paired with Buttondown through the Model Context Protocol.

The largest ecosystem of integrations, chains, and agents. combine Buttondown MCP tools with 500+ LangChain components

Agent architecture supports ReAct, Plan-and-Execute, and custom strategies with full MCP tool access at every step

LangSmith tracing gives you complete visibility into tool calls, latencies, and token usage for production debugging

Memory and conversation persistence let agents maintain context across Buttondown queries for multi-turn workflows

Buttondown + LangChain Use Cases

Practical scenarios where LangChain combined with the Buttondown MCP Server delivers measurable value.

RAG with live data: combine Buttondown tool results with vector store retrievals for answers grounded in both real-time and historical data

Autonomous research agents: LangChain agents query Buttondown, synthesize findings, and generate comprehensive research reports

Multi-tool orchestration: chain Buttondown tools with web scrapers, databases, and calculators in a single agent run

Production monitoring: use LangSmith to trace every Buttondown tool call, measure latency, and optimize your agent's performance

Buttondown MCP Tools for LangChain (10)

These 10 tools become available when you connect Buttondown to LangChain via MCP:

create_email

Create a new email or draft

create_subscriber

Add a new subscriber to the newsletter

get_account_info

Retrieve core account/profile settings

get_email

Get details of a specific email

get_email_analytics

Get analytics for a specific email

get_subscriber

Get details of a specific subscriber

list_emails

List all sent emails and drafts

list_newsletters

List all newsletters in the account

list_subscribers

List all newsletter subscribers

list_tags

List all subscriber tags

Example Prompts for Buttondown in LangChain

Ready-to-use prompts you can give your LangChain agent to start working with Buttondown immediately.

"List all my newsletter subscribers."

"Show analytics for my last sent email."

"Create a new draft with subject 'Hello World' and body 'This is a test'."

Troubleshooting Buttondown MCP Server with LangChain

Common issues when connecting Buttondown to LangChain through the Vinkius, and how to resolve them.

MultiServerMCPClient not found

Install: pip install langchain-mcp-adapters

Buttondown + LangChain FAQ

Common questions about integrating Buttondown MCP Server with LangChain.

How does LangChain connect to MCP servers?

Use langchain-mcp-adapters to create an MCP client. LangChain discovers all tools and wraps them as native LangChain tools compatible with any agent type.

Which LangChain agent types work with MCP?

All agent types including ReAct, OpenAI Functions, and custom agents work with MCP tools. The tools appear as standard LangChain tools after the adapter wraps them.