How to Use the Ecomail MCP in Vercel AI SDK

Q: How do I connect Ecomail to the Vercel AI SDK?

Install @ai-sdk/mcp and use createMCPClient with your HTTP transport URL. Pass the resulting mcpClient.tools() into your generateText or streamText call. Always remember to call mcpClient.close() when the request finishes.

Q: Can the Vercel AI SDK stream Ecomail templates to the client?

Yes. When your agent calls listemailtemplates, the SDK streams the tool execution results back to the frontend. Your React components can render the template previews as soon as the data arrives.

Q: Does Vercel AI SDK cache Ecomail campaign lists?

No, the SDK fetches live data every time the agent calls listemailmarketingcampaigns. If you need caching, you have to implement it at the Next.js route handler level.

Stream live Ecomail campaign metrics directly into your React frontend using the 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 Ecomail MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream Ecomail metrics via Vercel AI SDK

The `get_campaign_performance_details` tool lets your AI client fetch live open rates and click data. You pass the tool to `streamText`, and the Vercel AI SDK pushes those numbers straight to the browser. Users watch the dashboard populate instantly instead of staring at a loading spinner. We also included `quick_marketing_volume_audit` for high-level overviews. Your Next.js app renders the summary text as it generates, while the raw JSON data updates your chart components in real time.

Render subscriber profiles instantly

Calling `get_subscriber_profile` pulls the full history of a specific contact. When an admin searches for an email, the agent retrieves their past interactions and active lists. The SDK handles the transport layer automatically. You can pair this with `search_marketing_subscribers` to build a live search interface. As the user types, the agent queries the Ecomail API and streams the matching contact cards right into the UI.

Audit address lists on the edge

The `list_marketing_address_lists` tool returns every contact group configured in your account. Your agent reads this data to map out targeting options before drafting a new message. Once you pick a list, `list_address_list_subscribers` pulls the actual contacts. Because this MCP Server runs fast, you can execute these calls inside Edge Functions without hitting timeout limits.

Setup guide

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

Install `@ai-sdk/mcp` and use `createMCPClient` with your HTTP transport URL. Pass the resulting `mcpClient.tools()` into your `generateText` or `streamText` call. Always remember to call `mcpClient.close()` when the request finishes.

Yes. When your agent calls `list_email_templates`, the SDK streams the tool execution results back to the frontend. Your React components can render the template previews as soon as the data arrives.

No, the SDK fetches live data every time the agent calls `list_email_marketing_campaigns`. If you need caching, you have to implement it at the Next.js route handler level.

You likely forgot to configure the authProvider for your endpoint token. Vinkius endpoints require authentication, so check your transport configuration and ensure the environment variables are set correctly in your Vercel project.

Vinkius isolates every request in an ephemeral V8 sandbox. When your agent reads email addresses and contact histories, that data passes through a zero-trust boundary and never persists on our infrastructure. You hold the only endpoint token.

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