Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "google_ads-mcp": {
      "type": "http",
      "url": "https://api.mcp.ai/p_google_ads"
    }
  }
}

claude mcp add --transport http google_ads-mcp https://api.mcp.ai/p_google_ads

[mcp_servers.google_ads-mcp]
url = "https://api.mcp.ai/p_google_ads"

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "google_ads-mcp": {
      "type": "remote",
      "url": "https://api.mcp.ai/p_google_ads",
      "enabled": true
    }
  }
}

{
  "mcpServers": {
    "google_ads-mcp": {
      "type": "http",
      "url": "https://api.mcp.ai/p_google_ads"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=google_ads-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBpLm1jcC5haS9wX2dvb2dsZV9hZHMifQ%3D%3D"
}

{
  "servers": {
    "google_ads-mcp": {
      "type": "http",
      "url": "https://api.mcp.ai/p_google_ads"
    }
  }
}

{
  "mcpServers": {
    "google_ads-mcp": {
      "httpUrl": "https://api.mcp.ai/p_google_ads"
    }
  }
}

extensions:
  "google_ads-mcp":
    enabled: true
    name: "google_ads-mcp"
    type: streamable_http
    uri: "https://api.mcp.ai/p_google_ads"
    timeout: 300

Quality 88 / 100good

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene93 · weight 30

pass
tools.descriptionsevery tool has a description
warn
tools.description_length1 tools have descriptions over 1,024 characters, which crowds the context
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations35 of 35 tools declare readOnlyHint or destructiveHint
pass
tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
pass
tools.token_costabout 7,932 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability100 · weight 15

pass
stability.changesno tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

35 tools, about 7,932 tokens to load them all · tool set eb56d410c3fe · checked 2026-10-20 10:35 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 91 / 100

provenance80

liveness99

freshness85

hygiene100

+repository +namespace-matches-repo +reachable +uptime-98% ~updated-60d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://api.mcp.ai/p_google_ads` streamable-http	none	yes	98%	130 ms	2025-11-25	2026-10-20

Tools (35)

`authenticate`	MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.
`connect`read-only	Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.
`google_ads_account`read-only	Get Google Ads account info: name, currency, timezone for a customer (uses account + customer_id to resolve scope). Bulk support: accepts customer_ids for batched execution.
`google_ads_ad_group_create`	Create an ad group inside a campaign. Default status ENABLED, type SEARCH_STANDARD. Optional cpc_bid as the ad-group-level default max CPC. Bulk support: accepts campaign_ids, customer_ids for batched execution.
`google_ads_ad_group_update_status`	Pause, enable or remove ad groups. REMOVED is irreversible.
`google_ads_ads`read-only	List enabled ads with type, status, campaign name and ad_group_ad.policy_summary (approval_status, review_status, policy_topic_entries) — answers "why is my ad not serving?" without opening the Google Ads UI. Bulk support: accepts customer_ids for batched execution.
`google_ads_ad_update_status`	Pause, enable or remove ads. Each entry needs ad_group_id + ad_id because the ad resource is keyed by both (customers/X/adGroupAds/{ad_group_id}~{ad_id}). Bulk support: accepts customer_ids for batched execution.
`google_ads_campaign_budget_create`	Create a campaign_budget. Required to create a campaign. Amount is daily, in account currency unit (50 = R$50/day). Bulk support: accepts customer_ids for batched execution.
`google_ads_campaign_create`	Create a Google Ads campaign. Defaults to channel_type=SEARCH, status=PAUSED (safe), bidding_strategy=MANUAL_CPC. Provide budget_id from google_ads_campaign_budget_create. Declares no EU political advertising by default (Reg 2024/900, required by Google). Only SEARCH, DISPLAY and SHOPPING can be created through the API: VIDEO (YouTube) is read-only on Google side, and PERFORMANCE_MAX must be created together with its asset group. Build those two in the Google Ads interface and use this MCP to report on them. Bulk support: accepts budget_ids, merchant_ids, customer_ids for batched execution.
`google_ads_campaigns`read-only	List Google Ads campaigns with status and budgets. Default (ALL) returns both ENABLED and PAUSED campaigns; pass status ENABLED or PAUSED to narrow. REMOVED (deleted) campaigns are excluded. Bulk support: accepts customer_ids for batched execution.
`google_ads_campaign_update_budget`	Update the daily budget of a campaign. Pass the campaign id and the new amount in the account currency unit (R$50,50 -> 50.5; converted to micros internally). Bulk support: accepts campaign_ids, customer_ids for batched execution.
`google_ads_campaign_update_status`	Pause, enable or remove one or more Google Ads campaigns. REMOVED is irreversible. Pass campaign ids from google_ads_campaigns. Google rejects status changes on trial (draft/experiment) campaigns, which can only be changed in the Google Ads UI.
`google_ads_changes`read-only	Change history / audit log: who changed what in the account and when. Covers campaigns, ad groups, ads (headlines/descriptions/final URLs), keywords, budgets and bids, with the user_email who made each change, the client (web UI / API / bulk upload), the operation (CREATE/UPDATE/REMOVE), the changed field mask and the old→new resource. Backed by Google Ads change_event (last 30 days only, per customer). Pass `since`/`until` (YYYY-MM-DD or "YYYY-MM-DD HH:MM:SS") or `days`; for incremental polling pass `since` = the last seen change timestamp. Bulk support: accepts customer_ids for batched execution.
`google_ads_keyword_add`	Add positive keywords to an ad group. Each keyword: { text, match_type, cpc_bid? }. match_type = EXACT \| PHRASE \| BROAD. Bulk support: accepts ad_group_ids, customer_ids for batched execution.
`google_ads_keywords_diagnostics`read-only	Keyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT. Uses account + customer_id for scope. Actions: `keywords` (last 7 days metrics top 50), `search_terms` (last 7 days), `status` (ALL enabled keywords with approval_status, system_serving_status — e.g. RARELY_SERVED for "Low search volume" — and disapproval_reasons; answers "why is my keyword not serving?"), `diagnostics` (Quality Score, position estimates / top-of-page CPC, impression share, rank-lost; answers "is it bid or Quality Score?"; bundles per-campaign budget-loss as `_campaign_budget_loss` since budget is a campaign property, not keyword; supports campaign_id/ad_group_id filters and days=7\|14\|30), `raw` (any GAQL SELECT). [Flattened action: diagnostics] Bulk support: accepts campaign_ids, ad_group_ids, customer_ids for batched execution.
`google_ads_keywords_keywords`read-only	Keyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT. Uses account + customer_id for scope. Actions: `keywords` (last 7 days metrics top 50), `search_terms` (last 7 days), `status` (ALL enabled keywords with approval_status, system_serving_status — e.g. RARELY_SERVED for "Low search volume" — and disapproval_reasons; answers "why is my keyword not serving?"), `diagnostics` (Quality Score, position estimates / top-of-page CPC, impression share, rank-lost; answers "is it bid or Quality Score?"; bundles per-campaign budget-loss as `_campaign_budget_loss` since budget is a campaign property, not keyword; supports campaign_id/ad_group_id filters and days=7\|14\|30), `raw` (any GAQL SELECT). [Flattened action: keywords] Bulk support: accepts campaign_ids, ad_group_ids, customer_ids for batched execution.
`google_ads_keywords_raw`read-only	Keyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT. Uses account + customer_id for scope. Actions: `keywords` (last 7 days metrics top 50), `search_terms` (last 7 days), `status` (ALL enabled keywords with approval_status, system_serving_status — e.g. RARELY_SERVED for "Low search volume" — and disapproval_reasons; answers "why is my keyword not serving?"), `diagnostics` (Quality Score, position estimates / top-of-page CPC, impression share, rank-lost; answers "is it bid or Quality Score?"; bundles per-campaign budget-loss as `_campaign_budget_loss` since budget is a campaign property, not keyword; supports campaign_id/ad_group_id filters and days=7\|14\|30), `raw` (any GAQL SELECT). [Flattened action: raw] Bulk support: accepts campaign_ids, ad_group_ids, customer_ids for batched execution.
`google_ads_keywords_search_terms`read-only	Keyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT. Uses account + customer_id for scope. Actions: `keywords` (last 7 days metrics top 50), `search_terms` (last 7 days), `status` (ALL enabled keywords with approval_status, system_serving_status — e.g. RARELY_SERVED for "Low search volume" — and disapproval_reasons; answers "why is my keyword not serving?"), `diagnostics` (Quality Score, position estimates / top-of-page CPC, impression share, rank-lost; answers "is it bid or Quality Score?"; bundles per-campaign budget-loss as `_campaign_budget_loss` since budget is a campaign property, not keyword; supports campaign_id/ad_group_id filters and days=7\|14\|30), `raw` (any GAQL SELECT). [Flattened action: search_terms] Bulk support: accepts campaign_ids, ad_group_ids, customer_ids for batched execution.
`google_ads_keywords_status`read-only	Keyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT. Uses account + customer_id for scope. Actions: `keywords` (last 7 days metrics top 50), `search_terms` (last 7 days), `status` (ALL enabled keywords with approval_status, system_serving_status — e.g. RARELY_SERVED for "Low search volume" — and disapproval_reasons; answers "why is my keyword not serving?"), `diagnostics` (Quality Score, position estimates / top-of-page CPC, impression share, rank-lost; answers "is it bid or Quality Score?"; bundles per-campaign budget-loss as `_campaign_budget_loss` since budget is a campaign property, not keyword; supports campaign_id/ad_group_id filters and days=7\|14\|30), `raw` (any GAQL SELECT). [Flattened action: status] Bulk support: accepts campaign_ids, ad_group_ids, customer_ids for batched execution.
`google_ads_keyword_update_bid`	Update max CPC for one or more keywords. Bid in account currency unit (e.g. 1.5 = R$1,50). Bulk support: accepts customer_ids for batched execution.
`google_ads_keyword_update_status`	Pause, enable or remove keywords. Each entry needs ad_group_id + criterion_id (the keyword criterion id). Bulk support: accepts customer_ids for batched execution.
`google_ads_list_accounts`read-only	List all Google Ads MCCs and ALL customer accounts the OAuth token can access (via customers:listAccessibleCustomers — not just hierarchy of the MCC). Each customer comes enriched with descriptive_name, currency_code, time_zone, manager flag, status. Use the returned customer_id (10 digits) in `customer_id` on other tools, and `account` to pick the MCC connection when multiple are present. Bulk support: accepts customer_ids for batched execution.
`google_ads_negative_keyword_add`	Add negative keywords at campaign or ad group scope. Pass scope + the matching target_id (campaign_id or ad_group_id). Bulk support: accepts target_ids, customer_ids for batched execution.
`google_ads_performance`read-only	Daily performance breakdown: cost, impressions, clicks, conversions, revenue per day. Bulk support: accepts customer_ids for batched execution.
`google_ads_responsive_search_ad_create`	Create a Responsive Search Ad (RSA) inside an ad group. Headlines: 3-15 entries (each <= 30 chars). Descriptions: 2-4 entries (each <= 90 chars). final_urls required. Default status PAUSED. Bulk support: accepts ad_group_ids, customer_ids for batched execution.
`google_ads_roas`read-only	ROAS for a date range (defaults to current month). Per-campaign cost, conversions, revenue, plus _summary. Bulk support: accepts customer_ids for batched execution.
`google_ads_sitelink_create`	Create sitelink extensions and attach them to a campaign (default), the whole account (scope=customer) or an ad group. A sitelink is a SitelinkAsset (its own link_text + final_url, optionally 2 description lines) linked to the scope — it is NOT the ad's display path (that is path1/path2 on the RSA). link_text <= 25 chars; if you set descriptions you must set BOTH (each <= 35 chars). Google needs at least ~2 sitelinks to actually show them. The created assets are shared in the account library. Bulk support: accepts target_ids, customer_ids for batched execution.
`google_ads_sitelink_remove`	Detach sitelinks from a campaign / account / ad group. Pass the link_resource_name(s) from google_ads_sitelinks. Removes only the association (the shared sitelink asset stays in the account library), so it is reversible by re-attaching. Bulk support: accepts customer_ids for batched execution.
`google_ads_sitelinks`read-only	List sitelink assets in the account and where they are attached (campaign / account / ad group level), with each link's resource_name (pass it to google_ads_sitelink_remove) and status. Use to audit existing sitelinks before creating new ones. Bulk support: accepts customer_ids for batched execution.
`google_ads_status`read-only	Without account: overview of all Google Ads MCCs and customer_ids. With account (and optional customer_id): details for that scope. Bulk support: accepts customer_ids for batched execution.
`google_ads_today`read-only	Today Google Ads performance: cost, impressions, clicks, conversions, ROAS per campaign plus _summary. Bulk support: accepts customer_ids for batched execution.
`marketplace`	The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.
`report_bug`	Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
`show_version`read-only	Show the current MCP platform and adapter versions.
`toolkit_info`read-only	Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

Schemas: list_tools.

Similar MCP servers

More from io.github.mcp-dir

And 1,107 more from this publisher.

Official server.json

{
  "name": "io.github.mcp-dir/google_ads-mcp",
  "title": "Google Ads",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://api.mcp.ai/p_google_ads",
      "type": "streamable-http"
    }
  ],
  "version": "0.1.0",
  "repository": {
    "url": "https://github.com/mcp-dir/google_ads-mcp",
    "source": "github"
  },
  "description": "Full Google Ads management: read (campaigns, performance, ROAS, keywords, search terms) and write (p"
}