How to Use the Mailgun (Transactional Email & Domains) MCP in Google ADK

Q: How do I configure the Mailgun (Transactional Email & Domains) MCP Server inside a google-adk project?

Use the McpToolset class to point to the hosted HTTP endpoint. Pass this toolset directly to your LlmAgent constructor so Gemini can access the email tools.

Q: Can google-adk use Mailgun (Transactional Email & Domains) to clean up bounced emails?

Yes. The agent can fetch bad addresses using listbounces and then call deletebounce to clear them once you update your database records.

Q: How does the agent handle template selection?

The agent calls gettemplates to see what layouts are available on your domain. It reads the HTML structure and uses it to format the final email output.

Connect Google ADK agents to Mailgun to automate email delivery and track domain health alongside your BigQuery data.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Mailgun (Transactional Email & Domains) MCP to Google ADK

Create your Vinkius account to connect Mailgun (Transactional Email & Domains) 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 Mailgun (Transactional Email & Domains) with Google ADK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Connect BigQuery data to active email delivery

The `send_email` tool allows your Gemini agent to dispatch messages based on real-time data queries. By combining Google ADK with this MCP server, your agent can read customer segments from BigQuery and instantly send targeted updates. Before sending, the agent runs `validate_email` to clean the list. This keeps your bounce rates low without requiring manual CSV exports or external validation scripts.

Analyze massive delivery logs in Gemini

The `list_logs` tool pulls raw event data directly into Gemini's massive 1M+ token context window. The agent processes thousands of delivery, open, and drop events at once to find patterns in delivery failures. It combines this with `get_stats` to generate domain performance reports. You get a clear picture of your sending reputation without writing complex aggregation queries.

Audit DNS records using the Google ADK MCP Server

The `list_domains` tool retrieves all domains configured on your Mailgun account. Your agent checks each domain using `get_domain` to verify that SPF, DKIM, and MX records are correctly set up in your DNS provider. If a domain shows configuration errors, the agent flags the specific missing records. This helps DevOps teams catch setup issues before they cause emails to land in spam folders.

Setup guide

Set up Mailgun (Transactional Email & Domains) 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 Mailgun (Transactional Email & Domains) 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="Mailgun (Transactional Email & Domains)_agent",
    model="gemini-2.0-flash",
    instruction="You have access to Mailgun (Transactional Email & Domains) 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 Mailgun. 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 Mailgun (Transactional Email & Domains) 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 Mailgun (Transactional Email & Domains) MCP in Google ADK

Use the `McpToolset` class to point to the hosted HTTP endpoint. Pass this toolset directly to your `LlmAgent` constructor so Gemini can access the email tools.

Yes. The agent can fetch bad addresses using `list_bounces` and then call `delete_bounce` to clear them once you update your database records.

Yes. You can pass a specific list of tool names to the toolset configuration, limiting the agent to safe tools like `get_stats` while blocking write actions like `send_email`.

The agent calls `get_templates` to see what layouts are available on your domain. It reads the HTML structure and uses it to format the final email output.

Your API tokens and email payloads are transmitted over secure, encrypted channels directly to the Mailgun API. The Vinkius runtime executes each call in a zero-trust, short-lived environment that never caches your message bodies or DNS keys.

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