admob-manager-mcp
Provides complete control over Google AdMob REST API, enabling management of accounts, apps, ad units, mediation groups, A/B experiments, bidding mappings, and performance reporting.
Allows creation of bidding mappings to associate Meta Audience Network placement IDs with AdMob ad units.
Allows creation of bidding mappings to associate Unity Ads placement IDs with AdMob ad units.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@admob-manager-mcp list my AdMob apps"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Google AdMob Manager MCP Server
An enterprise-grade Model Context Protocol (MCP) server providing complete control over Google AdMob REST API (v1beta). Designed for AI Agents (Claude Desktop, Cursor, Antigravity/AGY) to automate AdMob publisher account management, apps, ad units, mediation groups, A/B experiments, bidding ad unit mappings, and performance reporting.
๐ Key Features
19 Complete REST API Tools: Full matrix covering Accounts, Apps, Ad Units, Ad Unit Mappings, Mediation Groups, A/B Experiments, and Performance Reports.
Zero-Config Auto Browser OAuth 2.0: Embedded Google OAuth 2.0 Client credentials (
w3wide-auth-services). Automatically opens your system browser for one-click Google AdMob login when unauthenticated.Auto Silent Token Refresh: Tokens are cached at
~/.config/admob-manager-mcp/tokens.jsonand silently refreshed automatically.Resilient 401/403 Auto-Retry: If tokens expire or permissions change, the server purges cached tokens and seamlessly re-prompts browser authorization.
Dual Transport Mode: Supports both standard Stdio transport (
npm run mcp) and Streamable HTTP transport with MCP v2 Native Auth (npm run mcp:http).Third-Party Bidding Mapping: Associate Meta Audience Network, Unity Ads, AppLovin, and ironSource Placement IDs with AdMob Ad Units.
Related MCP server: AdMob MCP Server
๐ Quickstart & Installation
Option 1: Run via NPX (Zero Install)
npx @w3wide/admob-manager-mcpOption 2: Global Installation
npm install -g @w3wide/admob-manager-mcp
admob-manager-mcpโ๏ธ MCP Client Configuration Examples
1. Claude Desktop Configuration
Add the following to your claude_desktop_config.json:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.jsonLinux:
~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"admob-manager": {
"command": "npx",
"args": ["-y", "@w3wide/admob-manager-mcp"]
}
}
}2. Cursor Configuration (.cursor/mcp.json or Global Settings)
Add to .cursor/mcp.json in your project or global Cursor MCP settings:
{
"mcpServers": {
"admob-manager": {
"command": "npx",
"args": ["-y", "@w3wide/admob-manager-mcp"]
}
}
}3. Antigravity / AGY / Local MCP Configuration (mcp.json)
Create mcp.json in your workspace directory:
{
"mcpServers": {
"admob-manager-mcp": {
"command": "node",
"args": ["/absolute/path/to/admob-manager-mcp/dist/index.js"]
}
}
}๐ Authentication & Google Cloud Setup
Embedded OAuth Client: Out of the box, the server uses embedded Google OAuth 2.0 Client credentials linked to
w3wide-auth-servicesGCP project.First Run: When an AI agent executes an AdMob tool, if
~/.config/admob-manager-mcp/tokens.jsondoes not exist:The server spins up a local callback listener on
http://localhost:3000/oauth2callback.Your default browser automatically pops up Google's OAuth consent screen.
Select your Google Account and click Allow.
Tokens are saved locally, and all future tool calls execute seamlessly.
๐ ๏ธ Complete MCP Tools Matrix (19 Tools)
Tool Name | Description | Key Parameters |
| Get AdMob publisher account details |
|
| List all AdMob publisher accounts |
|
| List supported ad sources for mediation |
|
| List adapters for a specific ad source |
|
| List all apps linked to publisher account |
|
| Create a new AdMob app |
|
| List ad units for an account |
|
| Create a new Banner/Interstitial/Rewarded ad unit |
|
| List bidding mappings for an ad unit |
|
| Create bidding mapping for Meta/Unity/AppLovin |
|
| Batch create up to 100 ad unit mappings |
|
| List mediation groups |
|
| Create a mediation group |
|
| Update an existing mediation group |
|
| Start an A/B mediation experiment |
|
| Stop an active A/B experiment |
|
| Generate AdMob Network performance report |
|
| Generate Mediation revenue & match rate report |
|
| Generate Campaign performance report |
|
๐งช Testing with MCP Inspector
Inspect and test all tools interactively in your browser:
npm run inspectorOpens http://localhost:5173 (or active inspector port) with full tool execution UI and parameter schema validation.
๐ License
This project is licensed under the MIT License.
Available Tools
19 toolsbatchCreateAdmobAdUnitMappingsC
Batch create ad unit mappings (Max 100 items per call).
Inputs: requests (required), publisherId.
createAdmobAdUnitB
Create a new ad unit under an AdMob publisher account.
Inputs: appId (required), displayName (required), format, adTypes, +2 more.
createAdmobAdUnitMappingC
Create an ad unit mapping for a specific ad unit.
Inputs: adapterId (required), adUnitName (required), state, adUnitConfigurations.
createAdmobAppB
Create a new app under an AdMob publisher account.
Inputs: platform (required), appStoreId, displayName, publisherId.
createAdmobMediationAbExperimentC
Create an A/B experiment for a mediation group.
Inputs: displayName (required), mediationGroupName (required), treatmentTrafficPercentage (required), variantChoice.
createAdmobMediationGroupB
Create a new mediation group in an AdMob publisher account.
Inputs: displayName (required), state, publisherId, targetedAppIds, +1 more.
generateAdmobCampaignReportC
Generate AdMob Campaign performance report (Date range between startDate and endDate cannot exceed 30 days).
Inputs: reportSpec (required), publisherId.
generateAdmobMediationReportC
Generate AdMob Mediation performance report. Revenue values are in micros ($1 USD = 1,000,000 micros).
Inputs: reportSpec (required), publisherId.
generateAdmobNetworkReportB
Generate AdMob Network performance report. Revenue values are in micros ($1 USD = 1,000,000 micros). AD_TYPE dimension cannot be combined with AD_REQUESTS, MATCH_RATE, or IMPRESSION_RPM.
Inputs: reportSpec (required), publisherId.
getAdmobAccountA
Fetch AdMob publisher account details (publisher ID, currency code, reporting time zone) from Google AdMob REST API v1beta accounts endpoint.
Inputs: publisherId.
listAdmobAccountsC
List accessible AdMob publisher accounts.
Inputs: pageSize, pageToken.
listAdmobAdSourceAdaptersB
List ad source adapters for a given ad source.
Inputs: adSourceParent (required), pageSize, pageToken.
listAdmobAdSourcesB
List ad sources in an AdMob publisher account.
Inputs: pageSize, pageToken, publisherId.
listAdmobAdUnitMappingsB
List ad unit mappings for a specific ad unit.
Inputs: adUnitName (required), filter, pageSize, pageToken.
listAdmobAdUnitsB
List ad units under an AdMob publisher account.
Inputs: filter, pageSize, pageToken, publisherId.
listAdmobAppsB
List applications under an AdMob publisher account.
Inputs: pageSize, pageToken, publisherId.
listAdmobMediationGroupsB
List mediation groups in an AdMob publisher account.
Inputs: filter, pageSize, pageToken, publisherId.
patchAdmobMediationGroupB
Patch an existing mediation group using updateMask.
Inputs: mediationGroup (required), mediationGroupName (required), updateMask.
stopAdmobMediationAbExperimentB
Stop an active mediation A/B experiment.
Inputs: variantChoice (required), experimentName (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
TDQS
Scored across 19 tools
Each tool targets a distinct resource and action (list, create, get, generate, etc.) with clear naming. The three report tools are differentiated by type (mediation, campaign, network). No overlapping purposes.
All tools follow a consistent camelCase convention with verb + 'Admob' + noun pattern (e.g., listAdmobAccounts, createAdmobAdUnit). No mixing of styles or inconsistent verb choices.
19 tools is well-scoped for an AdMob management server, covering accounts, apps, ad units, mappings, ad sources, mediation groups, experiments, and reports without unnecessary duplication.
Covers core creation and listing operations for main resources, but lacks update/delete for ad units, mappings, and mediation groups, and no explicit list for experiments. Some operations are missing, potentially causing agent dead ends.
Maintenance
Related MCP Connectors
SEO & marketing toolkit for AI agents: GA4, Search Console, AdSense, GTM, PageSpeed, Trends.
Manage Google Ads from ChatGPT, Claude or any MCP client. Sign in with OAuth or use an API key.
Run Google Ads and Meta Ads from ChatGPT or Claude: audit wasted spend, create and manage campaigns.
The simplest way to manage your Meta (Facebook and Instagram) ad accounts with your AI agent.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to manage Google Ads accounts by providing tools for querying account data and performing write operations such as updating campaign budgets, statuses, and bidding strategies.2Apache 2.0
- AlicenseNot gradedqualityDmaintenanceConnects Claude to the Google AdMob API to provide a conversational interface for managing and analyzing ad revenue data. It enables users to generate custom network reports, track performance trends, and diagnose revenue fluctuations using natural language.6MIT
- AlicenseNot gradedqualityDmaintenanceExposes the Google AdMob API as MCP tools for managing AdMob accounts, generating network and mediation reports, and listing apps and ad units.99 npm3Apache 2.0
- AlicenseAqualityDmaintenanceEnables querying mobile ad revenue from Google AdMob and Huawei Petal Ads through natural language, with read-only tools for account, app, ad unit, and revenue reports.11MIT