Skip to main content
Glama
admob-manager-mcp
by w3wide

Google AdMob Manager MCP Server

npm version License: MIT Model Context Protocol

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.json and 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-mcp

Option 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.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • Linux: ~/.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

  1. Embedded OAuth Client: Out of the box, the server uses embedded Google OAuth 2.0 Client credentials linked to w3wide-auth-services GCP project.

  2. First Run: When an AI agent executes an AdMob tool, if ~/.config/admob-manager-mcp/tokens.json does 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

getAdmobAccount

Get AdMob publisher account details

publisherId

listAdmobAccounts

List all AdMob publisher accounts

pageSize, pageToken

listAdmobAdSources

List supported ad sources for mediation

publisherId, pageSize

listAdmobAdSourceAdapters

List adapters for a specific ad source

adSourceParent, pageSize

listAdmobApps

List all apps linked to publisher account

publisherId, pageSize

createAdmobApp

Create a new AdMob app

publisherId, app

listAdmobAdUnits

List ad units for an account

publisherId, filter

createAdmobAdUnit

Create a new Banner/Interstitial/Rewarded ad unit

publisherId, adUnit

listAdmobAdUnitMappings

List bidding mappings for an ad unit

adUnitName, filter

createAdmobAdUnitMapping

Create bidding mapping for Meta/Unity/AppLovin

adUnitName, adUnitMapping

batchCreateAdmobAdUnitMappings

Batch create up to 100 ad unit mappings

publisherId, requests

listAdmobMediationGroups

List mediation groups

publisherId, filter

createAdmobMediationGroup

Create a mediation group

publisherId, mediationGroup

patchAdmobMediationGroup

Update an existing mediation group

mediationGroupName, mediationGroup

createAdmobMediationAbExperiment

Start an A/B mediation experiment

mediationGroupName, mediationAbExperiment

stopAdmobMediationAbExperiment

Stop an active A/B experiment

experimentName, variantChoice

generateAdmobNetworkReport

Generate AdMob Network performance report

publisherId, reportSpec

generateAdmobMediationReport

Generate Mediation revenue & match rate report

publisherId, reportSpec

generateAdmobCampaignReport

Generate Campaign performance report

publisherId, reportSpec


๐Ÿงช Testing with MCP Inspector

Inspect and test all tools interactively in your browser:

npm run inspector

Opens 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 tools
batchCreateAdmobAdUnitMappingsC

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

    B3.4/5.0

    Scored across 19 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    All tools follow a consistent camelCase convention with verb + 'Admob' + noun pattern (e.g., listAdmobAccounts, createAdmobAdUnit). No mixing of styles or inconsistent verb choices.

    Tool Count5/5

    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.

    Completeness3/5

    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

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables 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.
      2
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects 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.
      6
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Exposes the Google AdMob API as MCP tools for managing AdMob accounts, generating network and mediation reports, and listing apps and ad units.
      99 npm
      3
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      11
      MIT