ads-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ADMOB_OAUTH_PORT | No | Localhost port for the one-time OAuth flow | 8089 |
| ADMOB_TOKEN_PATH | No | Cached authorized user token file path | secrets/admob-token.json |
| HUAWEI_CLIENT_ID | No | Huawei OAuth client ID (preferred with HUAWEI_CLIENT_SECRET) | |
| HUAWEI_ADS_API_KEY | No | Combined `client_id:client_secret` fallback | |
| HUAWEI_CLIENT_SECRET | No | Huawei OAuth client secret (preferred with HUAWEI_CLIENT_ID) | |
| HUAWEI_ADS_REPORT_URL | No | Override for testing | Huawei production |
| HUAWEI_OAUTH_TOKEN_URL | No | Override for testing | Huawei production |
| HUAWEI_DEFAULT_CURRENCY | No | Default report currency (CNY, USD, EUR) | USD |
| ADMOB_CLIENT_SECRET_PATH | No | Google OAuth Desktop-app client JSON file path | secrets/client_secret.json |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| admob_list_accountsA | List the Google AdMob publisher accounts available to the authorized user. |
| admob_get_accountA | Get details (currency, timezone) for one AdMob publisher account. |
| admob_list_appsA | List apps registered under an AdMob account (paginated). |
| admob_list_ad_unitsA | List ad units under an AdMob account (paginated). |
| admob_network_reportA | Generate an AdMob Network report (revenue, impressions, eCPM, ...). Dimensions: DATE, MONTH, WEEK, AD_UNIT, APP, AD_TYPE, COUNTRY, FORMAT, PLATFORM, MOBILE_OS_VERSION, GMA_SDK_VERSION, APP_VERSION_NAME, SERVING_RESTRICTION. Only one time dimension (DATE/MONTH/WEEK) per request. Metrics: AD_REQUESTS, CLICKS, ESTIMATED_EARNINGS, IMPRESSIONS, IMPRESSION_CTR, IMPRESSION_RPM, MATCHED_REQUESTS, MATCH_RATE, SHOW_RATE. Monetary values are returned already divided from micros into currency units. |
| admob_mediation_reportA | Generate an AdMob Mediation report (per ad-source revenue and performance). Dimensions: DATE, MONTH, WEEK, AD_SOURCE, AD_SOURCE_INSTANCE, AD_UNIT, APP, MEDIATION_GROUP, COUNTRY, FORMAT, PLATFORM, MOBILE_OS_VERSION, GMA_SDK_VERSION, APP_VERSION_NAME, SERVING_RESTRICTION. Only one time dimension (DATE/MONTH/WEEK) per request. Metrics: AD_REQUESTS, CLICKS, ESTIMATED_EARNINGS, IMPRESSIONS, IMPRESSION_CTR, MATCHED_REQUESTS, MATCH_RATE, OBSERVED_ECPM. Monetary values are returned already divided from micros into currency units. |
| petal_reportA | Query the Huawei Petal Ads Publisher Service Reporting API with full control over grouping, filtering, ordering, and pagination. Returns monetization data (earnings, ad requests, impressions, clicks, match/show/click rates). |
| petal_revenue_summaryA | Daily Petal Ads earnings trend plus totals for a date range (defaults to the last 7 days). Convenience wrapper around petal_report. |
| petal_apps_performanceA | Per-app (optionally per-placement) Petal Ads earnings breakdown for a date range, ordered by earnings. Convenience wrapper around petal_report. |
| ads_revenue_overviewA | Combined ad revenue overview across Google AdMob and Huawei Petal Ads for a date range (defaults to the last 7 days): totals per network, grand total, and a daily breakdown. Networks that are not configured are reported but do not block the other. |
| ads_auth_statusA | Check which ad networks are configured and authorized (AdMob OAuth token, Huawei credentials). Optionally performs a live Huawei token test. Never returns secret values. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 11 tools
Each tool has a distinct purpose, with clear separation between admob and petal ads operations. The two report types (mediation and network) are differentiated, and convenience wrappers are explicitly noted.
All tools use a consistent prefix (admob_, ads_, petal_) with snake_case verb_noun pattern. Verbs like get, list, report, and auth_status are uniformly applied, making the set predictable.
11 tools cover the necessary operations for ad revenue reporting: account info, ad units, apps, two report types for admob, auth status, combined overview, and three petal tools. No excess or deficiency.
The tool set fully covers read-only access to ad monetization data from both AdMob and Huawei Petal Ads. Essential operations like listing, getting details, and generating reports are present, with no obvious gaps.