How to Use the Dotdigital MCP in Vercel AI SDK

Q: How do I handle Dotdigital rate limits in Vercel AI SDK?

You manage rate limits by calling getdotdigitalaccountmetadata to check your current plan thresholds. The Vercel AI SDK handles these limits best when you cache the metadata on the edge or set up conditional tool calls to avoid redundant requests.

Q: Can Vercel AI SDK stream Dotdigital campaign lists?

Yes, you can stream lists using listemailcampaigns inside your streamText function. The Vercel AI SDK renders the campaign titles and performance metrics on your frontend as they stream from the Dotdigital MCP Server.

Q: How does Vercel AI SDK execute Dotdigital automation programs?

Your agent triggers and monitors journeys by calling listautomationprograms within the SDK's execution loop. The Vercel AI SDK feeds the active program states directly into your UI components for immediate display.

Q: Can I use this with Next.js Server Actions?

Yes. You pass the Dotdigital tools to generateText inside your Server Action, retrieve the marketing data, and return it to your React components.

Stream real-time Dotdigital campaign stats and contact profiles directly into your Vercel AI SDK frontend without loading spinners.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Dotdigital MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream Dotdigital contact data live with Vercel AI SDK

The `get_contact_profile` tool lets your Vercel AI SDK application pull up a subscriber's complete history the second they ask for it. This means your Next.js frontend displays updated marketing profiles on the fly rather than making users wait for a full page reload. By passing this tool directly to `streamText`, your interface renders contact details block-by-block as the data arrives. You avoid building complex API polling mechanisms because the Vercel AI SDK handles the active connection to the Dotdigital MCP Server under the hood.

Build dynamic campaign selectors

The `list_email_campaigns` tool retrieves your active marketing runs so your Vercel AI SDK app can render them in interactive UI components. Your users can browse current newsletters or promotional blasts without you writing custom API wrappers or state management boilerplate. Integrating this with `list_email_templates` lets your agent draft new emails inside your custom React dashboard. Because the SDK works on the Edge, your team gets instant feedback on which templates are ready for deployment.

Real-time marketing health dashboards

The `quick_marketing_health_audit` tool aggregates critical account performance metrics into a single payload for your Vercel AI SDK chatbot. You can build an internal support tool that immediately tells your team if campaign metrics are dipping. Your AI client calls this tool alongside `get_dotdigital_account_metadata` to check current API limits and campaign volumes simultaneously. This setup keeps your Next.js marketing hub informed without hitting rate limits during peak traffic hours.

Setup guide

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

You manage rate limits by calling `get_dotdigital_account_metadata` to check your current plan thresholds. The Vercel AI SDK handles these limits best when you cache the metadata on the edge or set up conditional tool calls to avoid redundant requests.

Yes, you can stream lists using `list_email_campaigns` inside your `streamText` function. The Vercel AI SDK renders the campaign titles and performance metrics on your frontend as they stream from the Dotdigital MCP Server.

Your agent triggers and monitors journeys by calling `list_automation_programs` within the SDK's execution loop. The Vercel AI SDK feeds the active program states directly into your UI components for immediate display.

Yes. You pass the Dotdigital tools to `generateText` inside your Server Action, retrieve the marketing data, and return it to your React components.

Your Dotdigital contact profiles remain isolated within the Vinkius V8 sandbox. This MCP Server processes contact emails and address book data in ephemeral memory, meaning no subscriber data is stored or logged.

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