How to Use the AgentMail MCP in Vercel AI SDK

AgentMail gives your Vercel AI SDK frontends a real inbox. Read, send, and stream email data directly into your UI components.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect AgentMail MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live email streams in Vercel AI SDK

Your React components react immediately when `send_message` triggers. You don't wait for back-end polling because the tool results pipe directly into your stream. Watching `list_threads` update in real-time gives your users a live dashboard experience. The data hits the browser the second your agent finishes its task.

Direct inbox management via MCP Server

You control your agent's mail identity by calling `create_inbox` inside your Edge Functions. It keeps email logic isolated from your main application database. Managing custom domains is simple when you pass the configuration to the server. Your agent handles its own communication layer without extra boilerplate code.

Parsing attachments in the browser

Use `get_attachment` to pull files into your application state. The tool returns base64 content that you can render as a blob or download link instantly. Your UI handles the heavy lifting while the MCP Server manages the retrieval. It keeps your front-end logic clean and decoupled from the email provider.

Setup guide

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

Install the MCP client package and point it to your server URL. You then pass the tool definitions into your generateText call to give your model email access.

Yes, it runs on the edge without issue. Since it uses standard HTTP transport, your latency stays low for every email action.

It does. Because the tools integrate with the streamText method, your UI updates as soon as the email is sent or received.

We isolate your email keys within the Vinkius sandbox. Your credentials never touch your client-side code.

Your email bodies and metadata stay inside the ephemeral sandbox. We wipe all logs immediately after your request finishes.

Use it with your favorite AI tools

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