How to Use the BigMailer MCP in Google ADK

Q: How do I initialize the BigMailer toolset in Google ADK?

Install the package with pip install google-adk first. Then, define an McpToolset pointing to your Vinkius BigMailer endpoint and register it inside your Gemini LlmAgent tools list.

Q: Can I restrict Google ADK to only read BigMailer data?

Yes, you can pass a restricted list of tool names to the McpToolset constructor to limit what your Gemini agent can run. This lets you expose read-only BigMailer tools like listcontacts while completely hiding write operations.

Connect BigMailer marketing data directly to BigQuery and Vertex AI pipelines using the 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 BigMailer MCP to Google ADK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Sync BigQuery lists to BigMailer via Google ADK

This MCP Server lets your Gemini-powered agents pull user segments from BigQuery and immediately push them to your BigMailer lists. By exposing the `add_contact` tool, the Google ADK enables automated BigMailer updates based on real-time database queries. The Gemini agent processes millions of context tokens, allowing it to evaluate complex customer behaviors before deciding who to add to BigMailer. It then calls `list_contact_lists` to find the correct target BigMailer list and executes the update via the Google ADK.

Analyze bulk campaigns with Gemini long-context

Feed entire BigMailer campaign histories into your Google ADK agent using `list_bulk_campaigns` and `get_bulk_campaign`. Because Gemini models support massive token windows, your Google ADK agent can analyze months of BigMailer performance data in a single pass. The Google ADK manages the MCP tool execution, retrieving raw BigMailer campaign stats and passing them directly into your model's context. Your Gemini agent can then identify BigMailer trends, flag underperforming subject lines, and suggest copy improvements.

Map custom metadata schemas in Google Cloud

Use `get_brand_properties` and `list_brands` to align your Google Cloud data with your BigMailer email marketing platform. Your Google ADK agent reads your internal database schemas and maps them to your active BigMailer custom properties. This eliminates manual field-mapping errors when setting up new BigMailer marketing flows with the Google ADK. The Google ADK agent queries your active BigMailer brands, checks the available properties, and prepares the exact payload needed.

Setup guide

Set up BigMailer 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 BigMailer 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="BigMailer_agent",
    model="gemini-2.0-flash",
    instruction="You have access to BigMailer 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 BigMailer. 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 BigMailer 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 BigMailer MCP in Google ADK

Install the package with `pip install google-adk` first. Then, define an `McpToolset` pointing to your Vinkius BigMailer endpoint and register it inside your Gemini `LlmAgent` tools list.

Yes, you can pass a restricted list of tool names to the `McpToolset` constructor to limit what your Gemini agent can run. This lets you expose read-only BigMailer tools like `list_contacts` while completely hiding write operations.

The Google ADK sends the raw JSON payload from BigMailer tools like `get_bulk_campaign` straight into Gemini's context window. Gemini uses its high-capacity token limit to process the entire campaign history without hitting memory walls.

Yes, the BigMailer MCP Server works over both transports, but you'll typically use HTTP for your cloud-hosted Google ADK deployments.

Your BigMailer credentials reside securely within Vinkius's ephemeral environment. The Google ADK only receives the validated outputs of tools like `list_contacts`, keeping your underlying API tokens completely isolated.

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