How to Use the Instantly MCP in Mastra AI

Q: How do I add the Instantly MCP Server to a Mastra AI agent?

Instantiate the client using @mastra/mcp and point it to your Vinkius endpoint URL. Once initialized, call listTools and pass the returned tools directly into your agent's configuration to grant it campaign management capabilities.

Q: Can Mastra AI pause an Instantly campaign if bounce rates spike?

Yes, you can build a workflow that periodically checks getcampaignanalytics and instantly runs pausecampaign if bounces exceed your safe threshold. This programmatic guardrail runs autonomously in the background to protect your sender domains.

Q: How does Mastra AI handle lead import failures with Instantly?

Mastra's workflow engine automatically retries the addleads tool call with exponential backoff if the API rate limit is hit. If the import fails repeatedly, the workflow can branch to notify your team via Slack while keeping other operations active.

Q: Can I check Instantly sending account health in Mastra AI?

Your agent can call listaccounts and getaccountstats within any workflow to verify inbox statuses. This allows you to build pre-flight checks that ensure your inboxes are fully functional before launching any new outbound push.

Automate cold outreach workflows with Mastra AI and this Instantly MCP Server to pause campaigns when bounces spike.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Instantly MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Auto-pause Instantly campaigns with Mastra AI

Protect your sender reputation by building automated safety loops in Mastra AI. Your agent can run a scheduled workflow that calls `get_campaign_analytics` every hour to check for sudden drops in open rates or spikes in bounces. If the bounce rate crosses your threshold, the workflow triggers a conditional branch to execute `pause_campaign` immediately. This hands-free protection stops your domain from getting blacklisted while you sleep, using the MCP Server to act before damage spreads.

Route leads to active campaigns based on inbox health

Don't dump leads into campaigns blindly. Use Mastra AI to check the health of your sending infrastructure via `get_account_stats` and `list_accounts` before routing new prospects. If the workflow detects that certain sending accounts are warming up or hitting daily limits, it dynamically shifts the target campaign. The workflow then uses `add_leads` to inject the prospects into the healthiest sequence, maximizing your daily deliverability.

Resume paused sequences after automatic inbox checks

When a campaign gets paused due to inbox issues, manual recovery is a bottleneck. Set up a Mastra AI workflow that monitors your sending accounts and automatically triggers `resume_campaign` once health stats recover. The workflow queries `list_campaigns` to find paused sequences, checks the underlying inbox health, and safely restarts the outreach. It keeps your sales pipeline moving without requiring constant human monitoring.

Setup guide

Set up Instantly 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 Instantly 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: "instantly-mcp-client",
  servers: {
    "instantly-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent Instantly 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 Instantly. 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 Instantly 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 Instantly MCP in Mastra AI

Instantiate the client using `@mastra/mcp` and point it to your Vinkius endpoint URL. Once initialized, call `listTools` and pass the returned tools directly into your agent's configuration to grant it campaign management capabilities.

Yes, you can build a workflow that periodically checks `get_campaign_analytics` and instantly runs `pause_campaign` if bounces exceed your safe threshold. This programmatic guardrail runs autonomously in the background to protect your sender domains.

Mastra's workflow engine automatically retries the `add_leads` tool call with exponential backoff if the API rate limit is hit. If the import fails repeatedly, the workflow can branch to notify your team via Slack while keeping other operations active.

Your agent can call `list_accounts` and `get_account_stats` within any workflow to verify inbox statuses. This allows you to build pre-flight checks that ensure your inboxes are fully functional before launching any new outbound push.

Your cold email leads, campaign structures, and API keys are protected by the zero-trust architecture of the Vinkius sandbox. This MCP Server executes in an isolated environment, ensuring your sensitive sales data is never exposed or stored externally.

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