How to Use the MailerSend MCP in Vercel AI SDK

Q: How do I configure MailerSend with Vercel AI SDK?

Install the @ai-sdk/mcp package and initialize the client using createMCPClient with your Vinkius HTTP endpoint. Pass the tools directly into the tools parameter of streamText so your agent can trigger sendtransactionalemail on demand.

Q: How can I trace specific sent messages in my UI?

You can call getsentmessagedetails by passing the message ID returned from a previous send. The agent will fetch the delivery status, opens, and clicks, then stream those details straight to your custom React tracking component.

Get real-time MailerSend stats and trigger transactional sends directly inside your Vercel AI SDK frontend.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MailerSend MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pipe MailerSend activity to Vercel AI SDK

Use `list_domain_activity` to display live outbound logs directly on your Vercel AI SDK frontend without polling your backend database. Your users can see exactly when their transactional emails hit the network. The tool results stream directly into your UI components in real-time. This means your users get instant visual feedback when checking domain health or tracking a specific message via `get_sent_message_details`.

Trigger transactional sends from Edge Functions

Trigger `send_transactional_email` directly from your edge-deployed AI client without bundling heavy SMTP libraries. Since this MCP Server runs in a secure, lightweight Vinkius sandbox, your Vercel AI SDK setup stays fast. The model handles formatting the recipient JSON, calls `send_bulk_transactional_emails` if needed, and returns the message ID instantly. Your React components receive the payload immediately, updating the UI state before the user even checks their inbox.

Verify domains live in your admin dashboard

Run `list_sender_domains` to build a self-service domain setup wizard using Vercel AI SDK and MCP. Your agent can pull current DNS records, display them to the user, and then run `verify_sender_domain` once the user updates their registrar. This setup removes the back-and-forth of manual support tickets. The agent guides the developer through the DNS setup, checks the status with `get_sender_domain_details`, and reports the verified status in a live chat interface.

Setup guide

Set up MailerSend 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 MailerSend 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 MailerSend 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 MailerSend. 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 MailerSend 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 MailerSend MCP in Vercel AI SDK

Install the `@ai-sdk/mcp` package and initialize the client using `createMCPClient` with your Vinkius HTTP endpoint. Pass the tools directly into the `tools` parameter of `streamText` so your agent can trigger `send_transactional_email` on demand.

Yes, your agent can group multiple recipient objects and call the `send_bulk_transactional_emails` tool in a single execution. This is ideal for batch notifications triggered from a Vercel-hosted admin panel.

The SDK routes requests through the Vinkius MCP Server, which handles the underlying HTTP requests to MailerSend. If you hit rate limits, the API returns standard error codes that your agent can read and explain to the user.

You can call `get_sent_message_details` by passing the message ID returned from a previous send. The agent will fetch the delivery status, opens, and clicks, then stream those details straight to your custom React tracking component.

Vinkius processes all email addresses, message bodies, and domain records in an ephemeral, zero-trust V8 sandbox. No recipient data is stored on Vinkius servers; it is passed directly to the MailerSend API and immediately wiped from memory.

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