Skip to content
Get MCP AdsGet MCP Ads, home
Start free

google_ads_get_simulations

Read-only planning/forecast query for campaign, ad group, or portfolio bidding simulations. One of 38 Google Ads tools on the Get MCP Ads MCP gateway.

Read-only planning/forecast query for campaign, ad group, or portfolio bidding simulations. Returns simulation metadata and projected point lists when available, with a metadata fallback.

Kind
Read
Discovery
Reachable through search_tools and run_tool
Account parameter
customerId
Endpoint
https://mcp.getmcpads.com/google-ads/mcp

ParametersLink to this section

NameTypeRequiredNotes
customerIdstringRequiredGoogle Ads customer ID (without dashes, e.g., 1234567890)
levelstringOptionalSimulation resource level to query. One of: campaign, ad_group, bidding_strategy. Default: "campaign".
campaignIdstringOptionalOptional campaign ID filter. Applies directly to campaign simulations and as campaign context for ad group simulations.
adGroupIdstringOptionalOptional ad group ID filter for ad_group simulations.
biddingStrategyIdstringOptionalOptional portfolio bidding strategy ID filter for bidding_strategy simulations.
simulationStartDatestringOptionalOptional minimum simulation start date YYYY-MM-DD.
simulationEndDatestringOptionalOptional maximum simulation end date YYYY-MM-DD.
typeFilterstringOptionalOptional SimulationType enum, e.g. BUDGET, TARGET_CPA, TARGET_ROAS, CPC_BID.
modificationMethodstringOptionalOptional SimulationModificationMethod enum, e.g. UNIFORM, SCALING, DEFAULT.
limitintegerOptionalDefault: 1000.

Calling itLink to this section

jsonThrough run_tool, since it is not announced
{
  "name": "run_tool",
  "arguments": {
    "name": "google_ads_get_simulations",
    "args": {
      "customerId": "<string>"
    }
  }
}
Esc

Type to search