How to Use the AMcards MCP in Vercel AI SDK

Q: How do I install the AMcards MCP Server with Vercel AI SDK?

Run npm install ai @ai-sdk/mcp in your project. Set up the client using createMCPClient with your Vinkius HTTP endpoint and pass the tools directly into your generation function.

Q: Can I stream AMcards template lists with Vercel AI SDK?

Yes. Your agent calls listcardtemplates and streams the JSON array directly into your UI components, rendering previews as they arrive.

Q: How does Vercel AI SDK handle AMcards webhook registration?

The agent uses listconfiguredwebhooks to inspect active triggers. You write edge handlers that listen to these webhooks to update your local database when cards ship.

Q: Do I need to close the MCP connection in Next.js?

Always run mcpClient.close() when your edge execution finishes. This prevents open connections from hanging in your serverless environment.

Build Next.js apps where your Vercel AI SDK client streams live physical card delivery status and templates straight to your users.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect AMcards MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream live card templates using Vercel AI SDK

This MCP Server connects your web interface directly to physical greeting cards via `list_card_templates`. Your AI client renders real-time template previews on the edge without blocking the main UI thread. Users watch options populate instantly as the stream resolves. You pass these templates directly to `send_greeting_card` to trigger physical mailings based on real-time user selections.

Track actual mail history on the edge

Your agent calls `get_card_sending_history` to pull past deliveries and display them in your React or Vue frontend. No more spinning wheels while waiting for third-party shipping databases to respond. Because Vercel AI SDK handles streaming tool calls natively, the agent updates the UI the millisecond the API responds. You keep users informed of exactly when their physical cards hit the mail.

Automated drip campaigns from UI events

Trigger physical mail sequences using `trigger_drip_campaign` and check current flows with `list_drip_campaigns`. Your app triggers these physical touchpoints based on user milestones or sign-ups. You configure the MCP client using `createMCPClient` with an HTTP transport. This lets your edge functions start multi-card print campaigns instantly without spin-up delays.

Setup guide

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

Run `npm install ai @ai-sdk/mcp` in your project. Set up the client using `createMCPClient` with your Vinkius HTTP endpoint and pass the tools directly into your generation function.

Yes. Your agent calls `list_card_templates` and streams the JSON array directly into your UI components, rendering previews as they arrive.

The agent uses `list_configured_webhooks` to inspect active triggers. You write edge handlers that listen to these webhooks to update your local database when cards ship.

Always run `mcpClient.close()` when your edge execution finishes. This prevents open connections from hanging in your serverless environment.

Your physical mailing addresses and recipient names go straight to the printing service via encrypted V8 sandbox isolates. Vinkius does not store these contact details, keeping your customer mailing lists safe.

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