How to Use the Flodesk MCP in Vercel AI SDK

Q: Can I use Vercel AI SDK to add subscribers to Flodesk segments?

Yes. Use addsubscribertosegment inside your tool definitions to let your AI client categorize users on the fly. The SDK handles the execution and returns the updated segment status to your frontend.

Q: How do I trigger a Flodesk workflow using Vercel AI SDK?

Call addsubscribertoworkflow within your agent's execution loop. This immediately starts the specified Flodesk email sequence for the target subscriber email, bypassing manual webhook configuration.

Stream real-time Flodesk subscriber updates and segment lists directly 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 Flodesk MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream live Flodesk data into Vercel AI SDK views

The `list_subscribers` tool pulls your entire audience directory directly into your React components without waiting for background API resolutions. Your AI client fetches the list and streams the state changes live to the user's screen, bypassing the typical loading spinners that kill web app engagement. By pairing this with `list_custom_fields`, your frontend renders custom subscriber attributes on the fly. It makes managing your email audience inside custom dashboards feel instantaneous because the data flows through Edge Functions without blocking the main thread.

Instant segment creation

The `create_segment` tool lets your web application build new targeted email lists instantly based on real-time user actions. Instead of writing complex backend API glue code, you let your AI client execute the tool and immediately display the newly created segment details in the browser. You can immediately follow up with `add_subscriber_to_segment` to sort users based on their in-app behavior. Because the Vercel AI SDK handles the stream via our MCP Server, your users see their subscription status update in real-time.

Trigger Flodesk workflows from Edge Functions

The `add_subscriber_to_workflow` tool connects your live application events directly to Flodesk email sequences using this MCP integration. When a user triggers an event, your AI client calls this tool to kick off onboarding emails without adding server-side latency. You use `upsert_subscriber` alongside it to ensure the user's profile is created or updated before the email sequence starts. This keeps your user database and email marketing platform perfectly synchronized with zero manual sync scripts.

Setup guide

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

You register the Flodesk MCP Server with your SDK client and call `list_subscribers` within `streamText`. The tools stream their raw JSON results directly into your UI components, allowing real-time rendering of your audience data.

Yes. Use `add_subscriber_to_segment` inside your tool definitions to let your AI client categorize users on the fly. The SDK handles the execution and returns the updated segment status to your frontend.

Call `add_subscriber_to_workflow` within your agent's execution loop. This immediately starts the specified Flodesk email sequence for the target subscriber email, bypassing manual webhook configuration.

No. You run the MCP client inside Vercel Edge Functions, which connects your AI client directly to the hosted Flodesk API with minimal latency.

Your subscriber emails and custom field data are processed inside an isolated V8 sandbox. Vinkius secures these data payloads during transit, ensuring your marketing list never leaks to public LLM training sets.

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