Kristopher Overholt
10 KiB
catalog_title, catalog_description, catalog_icon, catalog_tags
| catalog_title | catalog_description | catalog_icon | catalog_tags | ||
|---|---|---|---|---|---|
| Adspirer | Create, manage, and optimize ad campaigns across Google, Meta, LinkedIn, and TikTok Ads | /integrations/assets/adspirer.png |
|
Adspirer MCP tool for ADK
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:
- Connect — Your ADK agent connects to
https://mcp.adspirer.com/mcpand authenticates via OAuth 2.1. On first run, a browser window opens for you to sign in and authorize access to your ad accounts. - Discover — The agent discovers available tools based on your connected ad platforms (Google Ads, Meta Ads, LinkedIn Ads, TikTok Ads).
- 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 available)
- 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
=== "Python"
=== "Local 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.
```python
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-flash-latest",
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,
),
)
],
)
```
=== "Remote MCP Server"
If you already have an Adspirer access token, you can connect directly
using Streamable HTTP without the OAuth browser flow.
```python
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-flash-latest",
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}",
},
),
)
],
)
```
=== "TypeScript"
=== "Local 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.
```typescript
import { LlmAgent, MCPToolset } from "@google/adk";
const rootAgent = new LlmAgent({
model: "gemini-flash-latest",
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 };
```
=== "Remote MCP Server"
If you already have an Adspirer access token, you can connect directly
using Streamable HTTP without the OAuth browser flow.
```typescript
import { LlmAgent, MCPToolset } from "@google/adk";
const ADSPIRER_ACCESS_TOKEN = "YOUR_ADSPIRER_ACCESS_TOKEN";
const rootAgent = new LlmAgent({
model: "gemini-flash-latest",
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 |