How to Use the MailerCheck MCP in Vercel AI SDK

Q: How do I use MailerCheck with the Vercel AI SDK?

Install the @ai-sdk/mcp package and create a client pointing to your Vinkius endpoint URL. The MailerCheck tools will then be available on the mcpClient.tools() object, ready to be passed to generateText or streamText.

Q: Can I check emails one by one with the Vercel AI SDK and MailerCheck?

Yes. The verifysingleemail tool is designed for this. Your agent can call it to get a fast, real-time check on a single email address, and you can stream the result directly into your UI.

Q: What's the best way to handle large lists?

Use the batch processing tools. Your agent should call createverificationbatch with the list of emails, then periodically call getbatchresults with the batch ID to get the outcome.

Q: How do I see all the batch jobs I've run with MailerCheck in my Vercel AI SDK app?

Have your agent use the listverificationbatches tool. It returns a list of all recent batches, which you can then display in an admin panel or dashboard in your application.

Instantly validate emails in your Vercel AI SDK app. Show users results as they type, with no 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 MailerCheck MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live Email Checks in Your UI

This MCP server gives your agent the `verify_single_email` tool. You can use it to check an email address the moment a user types it into a form. With the Vercel AI SDK, the result streams directly back to your UI. Hook it up to `generateText` and display a validation message right below the input field. The check is fast, so the feedback feels instant.

Process Email Lists on the Edge

For bigger jobs, your agent can use `create_verification_batch` to upload a whole list of emails at once. This is perfect for cleaning a mailing list imported by a user. You can build a dashboard that uses `get_batch_results` to show cleaning progress in real time. Because you're using the AI SDK, you can stream the status updates directly to your Next.js or Svelte front-end, showing the user exactly what's happening.

Monitor API Credits with this MCP Server

Running out of API credits breaks your app. Use the `get_account_info` tool to have your agent check your MailerCheck balance programmatically. Build a simple admin utility that calls this tool and displays the remaining credits. You can even set up alerts when the balance gets low. It's a straightforward way to keep your service running without surprises.

Setup guide

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

Install the `@ai-sdk/mcp` package and create a client pointing to your Vinkius endpoint URL. The MailerCheck tools will then be available on the `mcpClient.tools()` object, ready to be passed to `generateText` or `streamText`.

Yes. The `verify_single_email` tool is designed for this. Your agent can call it to get a fast, real-time check on a single email address, and you can stream the result directly into your UI.

Use the batch processing tools. Your agent should call `create_verification_batch` with the list of emails, then periodically call `get_batch_results` with the batch ID to get the outcome.

Have your agent use the `list_verification_batches` tool. It returns a list of all recent batches, which you can then display in an admin panel or dashboard in your application.

Your Vercel AI SDK app sends email addresses to your Vinkius MCP endpoint. Vinkius forwards the data to the MailerCheck API in an ephemeral, isolated sandbox. Your data is never stored or logged by Vinkius.

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