How to Use the Ecomail MCP in Mastra AI

Q: How do I configure Mastra AI to use Ecomail tools?

Run npm install @mastra/mcp@latest and initialize a new MCPClient with your Vinkius server URL. Call mcpClient.listTools() and spread the results into your agent's tool configuration. Mastra auto-detects the transport type automatically.

Q: Can Mastra AI retry failed Ecomail API calls?

Yes. If a tool like getsubscriberprofile times out, Mastra's built-in workflow engine applies exponential backoff. The agent will attempt the call again based on your retry configuration.

Q: How do I add human-in-the-loop for Ecomail actions in Mastra AI?

Use the requireToolApproval setting in your Mastra agent config. When the agent tries to execute a sensitive tool, the workflow pauses until an administrator approves the action.

Build resilient Ecomail marketing workflows that handle API failures automatically using Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Ecomail MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Map Ecomail workflows with Mastra AI

The `list_latest_marketing_campaigns` tool identifies what your team sent recently. Your Mastra AI agent pulls this list and checks the status of each broadcast. If a campaign is missing, the workflow engine branches logic to alert a human. You can chain this directly into `get_campaign_performance_details` to analyze the results. Mastra handles the exponential backoff if the Ecomail API rate limits your requests during a heavy audit.

Automate subscriber list management

Using `search_marketing_subscribers`, your agent finds specific users based on incoming support tickets. The workflow then triggers `get_subscriber_profile` to pull their exact engagement history. If the user needs to be moved, the agent checks `list_marketing_address_lists` to find the correct destination. Because this MCP Server handles the raw requests, Mastra lets you wrap these steps in conditional blocks, ensuring the agent never acts on incomplete data.

Monitor account limits reliably

The `get_ecomail_account_metadata` tool exposes your current usage limits. You can schedule a daily Mastra workflow to read this data and verify you have enough capacity before sending a massive blast. For deeper checks, `quick_marketing_volume_audit` gives the agent a high-level summary of all list activity. If the volume spikes unexpectedly, Mastra can pause the workflow and require human approval before continuing.

Setup guide

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

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

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

Run `npm install @mastra/mcp@latest` and initialize a new `MCPClient` with your Vinkius server URL. Call `mcpClient.listTools()` and spread the results into your agent's tool configuration. Mastra auto-detects the transport type automatically.

Yes. If a tool like `get_subscriber_profile` times out, Mastra's built-in workflow engine applies exponential backoff. The agent will attempt the call again based on your retry configuration.

Use the `requireToolApproval` setting in your Mastra agent config. When the agent tries to execute a sensitive tool, the workflow pauses until an administrator approves the action.

Not usually. The framework catches transport errors and API timeouts natively. You only need to write logic for business-level failures, like an empty array returning from a subscriber search.

We run the server inside a stateless V8 Isolate. When your workflow fetches open rates and subscriber email addresses, the memory drops the moment the request finishes. No logs or cache remain on our side.

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