Adspirer MCP tool for ADK

Supported in ADKPythonTypeScript

The Adspirer MCP Server connects your ADK agent to Adspirer, an AI-powered advertising platform with 100+ tools across Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads. This integration gives your agent the ability to create, manage, and optimize ad campaigns using natural language — from keyword research and audience planning to campaign launch and performance analysis.

How it works

Adspirer is a remote MCP server that acts as a bridge between your ADK agent and advertising platforms. Your agent connects to Adspirer's MCP endpoint, authenticates via OAuth 2.1, and gains access to 100+ tools that map directly to ad platform APIs.

The typical workflow looks like this:

1. Connect — Your ADK agent connects to https://mcp.adspirer.com/mcp and authenticates via OAuth 2.1. On first run, a browser window opens for you to sign in and authorize access to your ad accounts.
2. Discover — The agent discovers available tools based on your connected ad platforms (Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads).
3. Execute — The agent can now execute the full campaign lifecycle through natural language: research keywords, plan audiences, create campaigns, analyze performance, optimize budgets, and manage ads — all without touching a dashboard.

Adspirer handles OAuth token management, ad platform API calls, and safety guardrails (e.g., cannot delete campaigns or modify existing budgets) so your agent can operate autonomously with built-in protections.

Use cases

• Campaign Creation: Launch complex ad campaigns across Google, Meta, LinkedIn, and TikTok through natural language. Create Search, Performance Max, YouTube, Demand Gen, image, video, and carousel campaigns without touching a dashboard.

• Performance Analysis: Analyze campaign metrics across all connected ad platforms. Ask questions like "Which campaigns have the best ROAS?" or "Where am I wasting spend?" and get actionable insights with optimization recommendations.

• Keyword Research & Planning: Research keywords using Google Keyword Planner with real CPC data, search volumes, and competition analysis. Build keyword strategies and add them directly to campaigns.

• Budget Optimization: Identify underperforming campaigns, detect budget inefficiencies, and get AI-driven recommendations for spend allocation across channels and campaigns.

• Ad Management: Add new ad groups, ad sets, and ads to existing campaigns. A/B test creatives, update ad copy, manage keywords, and pause or resume campaigns — all through your agent.

Prerequisites

• An Adspirer account (free tier includes 15 tool calls/month, no credit card required)
• At least one connected ad platform (Google Ads, Meta Ads, LinkedIn Ads, or TikTok Ads) — connect via your Adspirer dashboard after signing up
• See the Quickstart guide for step-by-step setup instructions

Use with agent

PythonTypeScript

Local MCP ServerRemote MCP Server

When you run this agent for the first time, a browser window opens automatically to request access via OAuth. Approve the request in your browser to grant the agent access to your connected ad accounts.

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
from mcp import StdioServerParameters

root_agent = Agent(
    model="gemini-3.0-pro",
    name="advertising_agent",
    instruction=(
        "You are an advertising agent that helps users create, manage, "
        "and optimize ad campaigns across Google Ads, Meta Ads, "
        "LinkedIn Ads, and TikTok Ads."
    ),
    tools=[
        McpToolset(
            connection_params=StdioConnectionParams(
                server_params=StdioServerParameters(
                    command="npx",
                    args=[
                        "-y",
                        "mcp-remote",
                        "https://mcp.adspirer.com/mcp",
                    ],
                ),
                timeout=30,
            ),
        )
    ],
)

If you already have an Adspirer access token, you can connect directly using Streamable HTTP without the OAuth browser flow.

from google.adk.agents import Agent
from google.adk.tools.mcp_tool import McpToolset, StreamableHTTPConnectionParams

ADSPIRER_ACCESS_TOKEN = "YOUR_ADSPIRER_ACCESS_TOKEN"

root_agent = Agent(
    model="gemini-3.0-pro",
    name="advertising_agent",
    instruction=(
        "You are an advertising agent that helps users create, manage, "
        "and optimize ad campaigns across Google Ads, Meta Ads, "
        "LinkedIn Ads, and TikTok Ads."
    ),
    tools=[
        McpToolset(
            connection_params=StreamableHTTPConnectionParams(
                url="https://mcp.adspirer.com/mcp",
                headers={
                    "Authorization": f"Bearer {ADSPIRER_ACCESS_TOKEN}",
                },
            ),
        )
    ],
)

Local MCP ServerRemote MCP Server

When you run this agent for the first time, a browser window opens automatically to request access via OAuth. Approve the request in your browser to grant the agent access to your connected ad accounts.

import { LlmAgent, MCPToolset } from "@google/adk";

const rootAgent = new LlmAgent({
    model: "gemini-3.0-pro",
    name: "advertising_agent",
    instruction:
        "You are an advertising agent that helps users create, manage, " +
        "and optimize ad campaigns across Google Ads, Meta Ads, " +
        "LinkedIn Ads, and TikTok Ads.",
    tools: [
        new MCPToolset({
            type: "StdioConnectionParams",
            serverParams: {
                command: "npx",
                args: [
                    "-y",
                    "mcp-remote",
                    "https://mcp.adspirer.com/mcp",
                ],
            },
        }),
    ],
});

export { rootAgent };

If you already have an Adspirer access token, you can connect directly using Streamable HTTP without the OAuth browser flow.

import { LlmAgent, MCPToolset } from "@google/adk";

const ADSPIRER_ACCESS_TOKEN = "YOUR_ADSPIRER_ACCESS_TOKEN";

const rootAgent = new LlmAgent({
    model: "gemini-3.0-pro",
    name: "advertising_agent",
    instruction:
        "You are an advertising agent that helps users create, manage, " +
        "and optimize ad campaigns across Google Ads, Meta Ads, " +
        "LinkedIn Ads, and TikTok Ads.",
    tools: [
        new MCPToolset({
            type: "StreamableHTTPConnectionParams",
            url: "https://mcp.adspirer.com/mcp",
            transportOptions: {
                requestInit: {
                    headers: {
                        Authorization: `Bearer ${ADSPIRER_ACCESS_TOKEN}`,
                    },
                },
            },
        }),
    ],
});

export { rootAgent };

Capabilities

Adspirer provides 100+ MCP tools for full-lifecycle ad campaign management across four major advertising platforms.

Capability	Description
Campaign creation	Launch Search, PMax, YouTube, Demand Gen, image, video, and carousel campaigns
Performance analysis	Analyze metrics, detect anomalies, and get optimization recommendations
Keyword research	Research keywords with real CPC, search volume, and competition data
Budget optimization	AI-driven budget allocation and wasted spend detection
Ad management	Create and update ads, ad groups, ad sets, headlines, and descriptions
Audience targeting	Search interests, behaviors, job titles, and custom audiences
Asset management	Validate, upload, and discover existing creative assets
Campaign controls	Pause, resume, update bids, budgets, and targeting settings

Supported platforms

Platform	Tools	Capabilities
Google Ads	49	Search, PMax, YouTube, Demand Gen campaigns, keyword research, ad extensions, audience signals
Meta Ads	30+	Image, video, carousel, DCO campaigns, pixel tracking, lead forms, audience insights
LinkedIn Ads	28	Sponsored content, lead gen, conversation ads, demographic targeting, engagement analysis
TikTok Ads	4	Campaign management and performance analysis

Additional resources

• Adspirer Website
• Quickstart Guide
• Tool Catalog
• Core Workflows
• Ad Platform Guides