How to Use the EmailOctopus MCP in Mastra AI

Q: Can Mastra AI retry failed EmailOctopus API calls?

Yes. If the agent hits a rate limit while running listemailcampaigns, the built-in workflow engine applies exponential backoff automatically.

Build resilient email marketing workflows in Mastra AI using the EmailOctopus MCP server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect EmailOctopus MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate complex list audits

Dead emails cost money. Manual list cleaning takes hours. You can wire up a Mastra AI workflow to handle the entire audit automatically. The agent steps through your segments and identifies stale data without human intervention. It starts with `list_marketing_lists` to grab your active segments. Then it loops through `list_list_contacts` to find inactive addresses. If an API call fails, Mastra handles the exponential backoff and retries without dropping the task.

Build conditional campaign reporting

Not every email blast needs a deep dive. Sometimes you just want a quick pulse check. Your agent can decide which reporting path to take based on initial send volumes. First, it runs `list_successfully_sent_campaigns`. If the send count is high, Mastra branches the workflow to trigger `get_campaign_performance_summary` and `get_campaign_details`. You get heavy analysis only when the data justifies it.

Human-in-the-loop MCP Server actions

You probably don't want an autonomous script making assumptions about your VIP subscribers. Mastra lets you pause execution before the agent touches sensitive records. When the workflow needs to inspect a specific user, it queues up `search_contacts_by_email` and `get_contact_profile`. You use requireToolApproval to verify the request. The agent waits for your nod before pulling the personal history.

Setup guide

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

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

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

Install @mastra/mcp and create a new MCPClient instance with your server URL. Call mcpClient.listTools() and spread them into your agent's toolset.

Yes. If the agent hits a rate limit while running list_email_campaigns, the built-in workflow engine applies exponential backoff automatically.

Set requireToolApproval to true in your Mastra agent config. The workflow will pause before executing tools like get_contact_profile until a human signs off.

It does. Mastra AI handles complex branching logic perfectly. Your agent can run quick_marketing_volume_audit and branch into deeper analysis without timing out.

The server processes raw contact histories and email addresses. We isolate every execution in a zero-trust sandbox. The data routes directly back to your Mastra workflow and never touches persistent storage.

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