How to Use the Ecomail MCP in Google ADK

Q: How do I configure the Ecomail MCP Server in Google ADK?

Wrap your Vinkius URL in StreamableHttpServerParameters and pass it to McpToolset. Then, assign that toolset to your LlmAgent initialization. The agent will immediately see all available endpoints.

Q: Can Google ADK agents track my latest Ecomail campaigns?

Yes. The agent can call listlatestmarketingcampaigns to grab your most recent broadcasts. You can set this to run on a cron job to continuously feed fresh campaign data into BigQuery.

Q: Is it possible to limit which Ecomail tools the Google ADK agent sees?

You control exactly what the agent accesses. Use the toolnames parameter in your toolset configuration to expose only safe read operations like quickmarketingvolumeaudit while hiding deeper subscriber searches.

Give your Gemini agents access to Ecomail subscriber data using Google ADK.

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 Google ADK

Create your Vinkius account to connect Ecomail to Google ADK 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 Google ADK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Analyze Ecomail campaigns with Google ADK

Gemini's massive context window is wasted if it cannot read your actual marketing data. This MCP Server connects your Google ADK environment directly to Ecomail. Your agent can pull hundreds of campaign reports using `list_email_marketing_campaigns` and dump them straight into context. From there, you can route that data into Vertex AI or BigQuery. The agent uses `get_campaign_performance_details` to fetch granular click metrics, then correlates those numbers with your existing Google Cloud datasets to find hidden churn patterns.

Deep dive into subscriber behavior

Broad metrics hide specific user problems. When a high-value customer stops engaging, your Gemini agent can run `search_marketing_subscribers` to locate their exact record in your Ecomail database. It then pulls the full interaction log via `get_subscriber_profile`. Because Google ADK supports long-context reasoning, the agent can cross-reference this individual profile against months of past campaign data to figure out exactly which email caused them to tune out.

Map your marketing address lists

Enterprise setups usually have dozens of fragmented contact lists. Your agent can execute `list_marketing_address_lists` to map out your entire audience architecture in seconds without requiring manual exports. If you need to check list density, the agent follows up with `list_address_list_subscribers`. You pass the server URL into `McpToolset` and restrict exposed endpoints using the `tool_names` filter if you only want the agent reading specific lists.

Setup guide

Set up Ecomail MCP in Google ADK

Prerequisites

Python 3.10+ installed
google-adk package (pip install google-adk)
Active Vinkius subscription with a valid endpoint token

1

Install Google ADK

Run pip install google-adk to install the Agent Development Kit. MCP support is included via the McpToolset class.
2

Connect via SSE transport

Use McpToolset.from_server() with SseServerParams pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create an LlmAgent

Pass the returned mcp_tools list directly to LlmAgent(tools=mcp_tools). The ADK maps each MCP tool to a native Gemini function call — no manual schema definitions required.
4

Run with any Gemini model

The agent works with any Gemini model (gemini-2.0-flash, gemini-2.5-pro, etc.). Copy the full example on the right to get started with Ecomail tools in your ADK agent.

agent.py

from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import SseServerParams

# Connect to the MCP via SSE
mcp_tools, exit_stack = await McpToolset.from_server(
    connection_params=SseServerParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    )
)

# Create your agent with auto-discovered tools
agent = LlmAgent(
    name="Ecomail_agent",
    model="gemini-2.0-flash",
    instruction="You have access to Ecomail tools via MCP.",
    tools=mcp_tools,
)

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 Google ADK

Wrap your Vinkius URL in `StreamableHttpServerParameters` and pass it to `McpToolset`. Then, assign that toolset to your `LlmAgent` initialization. The agent will immediately see all available endpoints.

Yes. The agent can call `list_latest_marketing_campaigns` to grab your most recent broadcasts. You can set this to run on a cron job to continuously feed fresh campaign data into BigQuery.

You control exactly what the agent accesses. Use the `tool_names` parameter in your toolset configuration to expose only safe read operations like `quick_marketing_volume_audit` while hiding deeper subscriber searches.

It works perfectly. Gemini 1.5 Pro can ingest massive amounts of text, meaning it can process raw JSON outputs from `get_ecomail_account_metadata` alongside thousands of template files without forgetting the early context.

Your campaign open rates and click-through metrics flow through a zero-trust proxy layer. The server acts as a stateless bridge, meaning your marketing data passes to the Google ADK in memory and is never logged on our infrastructure.

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