Skip to main content
Glama
qalvinahmad

ads-mcp

by qalvinahmad

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ADMOB_OAUTH_PORTNoLocalhost port for the one-time OAuth flow8089
ADMOB_TOKEN_PATHNoCached authorized user token file pathsecrets/admob-token.json
HUAWEI_CLIENT_IDNoHuawei OAuth client ID (preferred with HUAWEI_CLIENT_SECRET)
HUAWEI_ADS_API_KEYNoCombined `client_id:client_secret` fallback
HUAWEI_CLIENT_SECRETNoHuawei OAuth client secret (preferred with HUAWEI_CLIENT_ID)
HUAWEI_ADS_REPORT_URLNoOverride for testingHuawei production
HUAWEI_OAUTH_TOKEN_URLNoOverride for testingHuawei production
HUAWEI_DEFAULT_CURRENCYNoDefault report currency (CNY, USD, EUR)USD
ADMOB_CLIENT_SECRET_PATHNoGoogle OAuth Desktop-app client JSON file pathsecrets/client_secret.json

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/qalvinahmad/ads-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server