How to Use the EmailOctopus MCP in Vercel AI SDK

Q: How does the Vercel AI SDK connect to the EmailOctopus MCP Server?

You use the createMCPClient method to establish an HTTP connection to the Vinkius endpoint. Once connected, pass the tools directly into streamText so your agent can manage your subscriber lists. This keeps your setup simple and edge-compatible.

Q: Can I use Vercel AI SDK to add contacts to EmailOctopus lists?

Yes, your agent can call the addcontacttolist tool directly. It handles the API call behind the scenes and streams the confirmation status back to your frontend. No complex backend routing is required on your end.

Q: Does the Vercel AI SDK support real-time campaign reporting with EmailOctopus?

It does. Your agent uses getcampaignsummaryreport to fetch active stats and streams the raw numbers straight into your React or Next.js UI components. This allows your team to view performance updates as they happen.

Watch subscriber lists and campaign stats stream live into your Next.js frontend with 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 EmailOctopus MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream subscriber counts into your UI

The Vercel AI SDK connects directly to your subscriber databases using our EmailOctopus MCP Server. Your agent can invoke `list_email_lists` or `get_list_details` and instantly show the updated numbers to your team. No middleware, no polling setups, just raw data flowing directly from the API into your frontend state.

Trigger onboarding flows on the edge

This EmailOctopus MCP Server integration runs on Edge Functions to handle user sign-ups instantly. By calling `add_contact_to_list` and then `trigger_automation_for_contact` in a single execution thread, your app kicks off welcome sequences instantly. Your users get their confirmation emails before they even have a chance to click away from your landing page.

Track Vercel AI SDK campaign metrics

Our EmailOctopus MCP Server fetches campaign performance metrics directly into your Vercel AI SDK interface. The agent uses `get_campaign_summary_report` to grab click rates, open rates, and bounces. It then passes those raw metrics directly to your UI components so your marketing team can see live updates on their active campaigns.

Setup guide

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

You use the `createMCPClient` method to establish an HTTP connection to the Vinkius endpoint. Once connected, pass the tools directly into `streamText` so your agent can manage your subscriber lists. This keeps your setup simple and edge-compatible.

Yes, your agent can call the `add_contact_to_list` tool directly. It handles the API call behind the scenes and streams the confirmation status back to your frontend. No complex backend routing is required on your end.

It does. Your agent uses `get_campaign_summary_report` to fetch active stats and streams the raw numbers straight into your React or Next.js UI components. This allows your team to view performance updates as they happen.

No, you don't. Vinkius manages your API credentials securely on its servers, meaning your frontend code never exposes sensitive keys to the browser. Your app only needs to talk to the secure proxy endpoint.

All subscriber email addresses and list details are processed in an isolated V8 sandbox. This means your customer contact information is never stored or logged permanently on our infrastructure, keeping your data safe from leaks. Transactions are ephemeral and secure.

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