How to Use the Convertlab MCP in Google ADK

Q: How do I restrict Google ADK to read-only tools?

Use the toolnames filter when initializing your McpToolset. By excluding createcustomer, you ensure the Gemini agent can only run read operations like getcustomer and listcampaigns.

Q: Where is my Convertlab customer data processed in Google ADK?

Customer profiles and segment lists accessed via listcustomers are processed in memory within your secure Google Cloud VPC. Vinkius handles the API authentication using zero-trust ephemeral environments, preventing marketing data exposure to external networks.

Connect Convertlab marketing data to Gemini long-context reasoning with 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 Convertlab MCP to Google ADK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Sync Convertlab campaigns with Google ADK agents

`list_campaigns` lets your Gemini agent ingest entire marketing histories into its million-token context window. The agent calls `get_campaign` to analyze multi-channel performance and match it against your BigQuery datasets. Because Google ADK runs natively on Google Cloud, your agent can query Convertlab and instantly export campaign summaries to Vertex AI. This allows you to run predictive models on your marketing performance without manual data exports.

Segment customers using Google Cloud tools

`list_member_groups` allows your LlmAgent to pull customer segments and cross-reference them with Cloud SQL databases. The agent uses `list_customers` to find high-value profiles that match specific campaign criteria. Use the Google ADK toolset to restrict access to sensitive operations. You can filter the exposed tools so your agent can read customer lists but cannot execute `create_customer` without manual approval.

Map marketing touchpoints through this MCP Server

`list_touchpoints` exposes user interaction history to your Gemini agent for deep attribution analysis. The agent evaluates touchpoint sequences against marketing events retrieved via `list_events`. This MCP Server uses standard transport protocols to connect Google ADK directly to Convertlab. Your agent tracks customer journeys, reads individual profiles with `get_customer`, and updates marketing dashboards in real time.

Setup guide

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

Instantiate McpToolset using StreamableHttpServerParameters with your Vinkius URL. Pass this toolset object into the tools list of your LlmAgent. Your Gemini agent will immediately recognize tools like `list_campaigns` and `list_touchpoints`.

Yes. You can pass multiple toolsets to your LlmAgent. The agent can fetch marketing segments using `list_member_groups` from Convertlab and join that data with offline warehouse tables in BigQuery in a single execution step.

Yes. The framework supports both Stdio and Streamable HTTP transports. When hosted on Vinkius, your Google ADK agent connects to the MCP Server endpoint securely over HTTPS to execute tools like `list_events`.

Use the tool_names filter when initializing your McpToolset. By excluding `create_customer`, you ensure the Gemini agent can only run read operations like `get_customer` and `list_campaigns`.

Customer profiles and segment lists accessed via `list_customers` are processed in memory within your secure Google Cloud VPC. Vinkius handles the API authentication using zero-trust ephemeral environments, preventing marketing data exposure to external networks.

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