How to Use the NeverBounce MCP in Mastra AI

Q: How do I connect Mastra AI to the NeverBounce MCP Server?

You instantiate the MCPClient from the @mastra/mcp package and pass the Vinkius URL for the NeverBounce server. Mastra handles the tool discovery, so functions like checkemail and getjobresults become available to your agent's workflow.

Q: What's the best way to manage multiple bulk jobs with NeverBounce and Mastra AI?

Create an agent that periodically calls listjobs to get all active and completed jobs. It can then loop through them, check getjobstatus, and download results for finished jobs using getjobresults. This all happens within a single, automated Mastra workflow.

Build resilient email verification workflows with NeverBounce and the Mastra AI framework. Automatic retries and conditional logic included.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect NeverBounce MCP to Mastra AI

Create your Vinkius account to connect NeverBounce to Mastra AI 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 NeverBounce with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate List Cleaning Workflows

Mastra AI is built for creating automated, multi-step sequences. You can set up a workflow that pulls a new list of contacts, sends it to NeverBounce using `create_job_from_input`, and then kicks off the cleaning process with `start_job`. No manual steps needed. The workflow engine lets you chain these actions together. Once `get_job_status` returns 'completed', your agent can automatically call `get_job_results` and pipe the clean email list directly into your marketing platform or CRM.

Handle Failures and Run Conditionals

What if a job fails to start because of a network blip? Mastra AI's automatic retries with exponential backoff will simply try the `start_job` tool again. You don't have to write that logic; it makes your automations far more robust. You can also build in conditional steps. For example, your agent can use `get_account_info` to check your credit balance. If credits are low, the workflow can send an alert to your admin team instead of trying to start a new bulk job.

Run NeverBounce Jobs with Mastra AI

Integrating this MCP Server is simple. You add the server URL to your `MCPClient` configuration, and Mastra automatically discovers all the available tools like `check_email` and `list_jobs`. They become native functions your agent can execute. This lets you build smarter logic. For instance, a workflow could `list_jobs` to find any that have been stuck in a 'processing' state for too long. After checking its `get_job_status`, the agent could decide to `delete_job` and restart the process automatically.

Setup guide

Set up NeverBounce MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All NeverBounce tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "neverbounce-mcp-client",
  servers: {
    "neverbounce-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "NeverBounce Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to NeverBounce tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent NeverBounce transactions"
);
console.log(result.text);

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 NeverBounce. 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 NeverBounce 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 NeverBounce MCP in Mastra AI

Mastra AI has built-in support for automatic retries with exponential backoff. If a network issue causes a call to `start_job` to fail, Mastra will try again on its own. This makes your email cleaning automations much more reliable.

Yes, that's a key feature of the framework. Your Mastra AI agent can first call the `get_account_info` tool. Then, you use Mastra's conditional logic to proceed with `create_job_from_url` only if the credit balance is sufficient.

You instantiate the `MCPClient` from the `@mastra/mcp` package and pass the Vinkius URL for the NeverBounce server. Mastra handles the tool discovery, so functions like `check_email` and `get_job_results` become available to your agent's workflow.

Create an agent that periodically calls `list_jobs` to get all active and completed jobs. It can then loop through them, check `get_job_status`, and download results for finished jobs using `get_job_results`. This all happens within a single, automated Mastra workflow.

The email address data is only passed through to the NeverBounce API. The Vinkius MCP Server that Mastra AI connects to operates in a zero-trust, ephemeral environment. Your data is processed in-memory and never written to disk 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