To connect Google Ads to the Agent Development Kit, add an McpToolset with StreamableHTTPConnectionParams pointing at https://mcp.paidsync.ai/mcp and send your PaidSync.ai API key in the Authorization header. The ADK agent can then call PaidSync.ai tools for Google Ads, Meta Ads and 12 other platforms.
ADK agents use an McpToolset to reach MCP servers. For PaidSync.ai you need:
ADK's docs show headers on the connection params, and say McpToolset can also manage OAuth 2.0 token refreshes through auth_scheme and auth_credential.
| Setting | Value |
|---|---|
| Class | McpToolset |
| Connection | StreamableHTTPConnectionParams |
| URL | https://mcp.paidsync.ai/mcp |
| Header | Authorization: Bearer, from an environment variable |
| Key limit | Reads and previews on Google Ads |
Applying a Google Ads change needs PaidSync.ai's OAuth sign-in, and a key cannot do it. Use the key for reporting agents, and keep a person in the loop for changes.
Do these in order. The code box holds the exact setup from Google ADK MCP tools docs.
Sign up at paidsync.ai and connect Google Ads on Google's own sign-in screen.
Create a key in your dashboard and export it as PAIDSYNC_API_KEY. Never put it in the URL.
Add the McpToolset from the box below to your LlmAgent's tools.
Start the agent with adk run or the web UI and ask about your account.
Confirm in the event log that a PaidSync.ai tool ran.
ADK agent with PaidSync.ai
import os
from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams
root_agent = LlmAgent(
model="gemini-flash-latest",
name="ads_analyst",
instruction="Answer questions about the user's ad accounts with PaidSync tools.",
tools=[McpToolset(connection_params=StreamableHTTPConnectionParams(
url="https://mcp.paidsync.ai/mcp",
headers={"Authorization": "Bearer " + os.environ["PAIDSYNC_API_KEY"]},
))],
)Start with a question that only reads, such as the account list, and check the event log for the tool call.
Setup follows Google's ADK documentation, checked on 24 October 2026. Source: Google ADK MCP tools docs. Every Google Ads tool is on the Google Ads MCP server page, and the full list of clients is on Connect your ads.
Yes. ADK's McpToolset connects an agent to remote MCP servers over Streamable HTTP.
Not for reports. A Bearer header with an API key works. ADK also documents OAuth support through auth_scheme.
With a key it reads and previews. Applying a Google Ads change needs the OAuth sign-in.
Yes. The same server exposes Meta Ads tools. See the Meta Ads MCP server page.
PaidSync.ai is free for 15 tasks a month with no card. Pro starts at $99 a month. See pricing.
PaidSync.ai runs 630+ tools across 14 ad and analytics platforms. Connect your accounts once and use them in the AI assistant you already work in.
Get Started Free Book a Demo