How to Use the MailboxPower MCP in Vercel AI SDK

Ship physical gifts and custom cards directly from your React or Next.js app with Vercel AI SDK streaming.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect MailboxPower MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live tracking for physical mail in Vercel AI SDK

Give your users real-time visual updates while your AI client triggers real-world direct mail using this MCP Server. Instead of staring at a blank screen or a generic loading wheel, users see the exact moment the server fires `send_shipment` to print a custom card. We render the payload data instantly in the React viewport. Your application updates the interface as soon as `list_automations` returns active campaigns, letting users verify physical touchpoints before they print.

Edge-fast contact creation via this MCP Server

Run your gifting workflows on Vercel Edge Functions without worrying about cold starts or heavy runtimes. When a customer upgrades their account, your AI client instantly calls `create_contact` to log their mailing address. The streaming response updates the browser immediately while the background process handles `add_contact_to_group` to segment the user. This setup keeps your database clean and your user interface snappy.

Let users trigger physical drip campaigns live

Put control back in your user's hands by letting them manage physical marketing sequences from your web app. Your agent can list available mail paths with `list_groups` and present them as interactive options. Once selected, the SDK streams the tool call to invoke `add_contact_to_automation` on the fly. The user watches the system schedule the physical gift without leaving your dashboard.

Setup guide

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

Use the createMCPClient method to connect to the server, then pass its tools to streamText. The SDK handles the streaming output, allowing your frontend to render the exact moment send_shipment executes.

Yes, the server runs in a secure sandbox, and the SDK client is fully compatible with Edge runtimes. You can call create_contact or get_contact inside middleware or edge API routes with zero performance penalty.

You map the tool execution states to your React or Vue components. When the MCP Server returns data via list_contacts, the SDK streams that payload directly to your UI, updating your local state without full-page reloads.

Always call mcpClient.close() once your streaming session finishes. Failing to close the connection can leave dangling HTTP sockets, which wastes server resources on your Next.js deployment.

The server handles all address data within Vinkius's zero-trust sandbox, so your Next.js app never exposes raw mailing details to the public internet. Calls to get_contact retrieve sensitive physical shipping addresses securely, using short-lived tokens that expire immediately after the tool run completes.

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