How to Use the Maildroppa MCP in Vercel AI SDK

Q: How do I get started with Maildroppa and the Vercel AI SDK?

First, install the AI SDK and its MCP package: npm install ai @ai-sdk/mcp. Then, create the client in your code, pointing it to your Vinkius endpoint URL. You can pass the tools from mcpClient.tools() directly to the generateText function.

Q: Can I manage subscriber tags in my Next.js app?

Yes. Your agent can use the createtag, listtags, and addtagtosubscriber tools. This lets a user, for example, type 'Tag this new subscriber as a VIP' and your AI client will execute the correct function.

Build reactive email list tools in your Next.js app with the Vercel AI SDK. See subscriber data stream 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 Maildroppa MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live Subscriber Management in Your UI

Let users manage subscribers right from your application. The `list_subscribers` tool streams contact data directly into your React components, so you don't need loading spinners. Your UI updates in real-time as the data arrives. From there, you can use `get_subscriber_details` to pull up a specific contact or `update_subscriber` to change their information on the fly. Because the Vercel AI SDK streams tool results, your app feels incredibly fast and responsive to the end user.

Organize Your Audience with the Vercel AI SDK

Give your users simple tools to organize their email lists. Your AI client can call `create_tag` to make new tags and then apply them to contacts using `add_tag_to_subscriber`. It all happens through simple, natural language commands. When it's time to build a new campaign list, your agent can use `list_segments` to see what's available or `create_segment` to make a new one from scratch. This MCP Server gives your front-end application direct control over backend email marketing tasks.

Connect Forms and Custom Fields

Pull your Maildroppa setup into your custom dashboard. The `list_sign_up_forms` tool lets your agent check on which forms are active. You can build interfaces that show form performance without ever leaving your app. Need to update specific user data? First, call `list_custom_fields` to see what's available. Then, your agent can use `update_subscriber_field` to change just one piece of information for a contact, like adding a birthday or updating a preference.

Setup guide

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

First, install the AI SDK and its MCP package: `npm install ai @ai-sdk/mcp`. Then, create the client in your code, pointing it to your Vinkius endpoint URL. You can pass the tools from `mcpClient.tools()` directly to the `generateText` function.

Yes. Your agent can use the `create_tag`, `list_tags`, and `add_tag_to_subscriber` tools. This lets a user, for example, type 'Tag this new subscriber as a VIP' and your AI client will execute the correct function.

Absolutely. Vinkius runs each MCP Server in a V8 Isolate sandbox, which is a zero-trust, ephemeral environment. Your connection is authenticated with a single endpoint token, so your credentials stay safe.

The main benefit is seeing results stream directly into your UI. Instead of waiting for a full API response, your React or Svelte components can render subscriber lists or details as they arrive, making your application feel much faster.

The server only processes the Maildroppa data your agent requests, like subscriber names, email addresses, and tags. All operations are stateless. Vinkius doesn't store your list data after the tool call is complete.

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