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.
- Source
- Google Ads
- Kind
- Read
- Discovery
- Reachable through
search_toolsandrun_tool - Account parameter
customerId- Endpoint
- https:/
/ mcp. getmcpads. com/ google-ads/ mcp
ParametersLink to this section
| Name | Type | Required | Notes |
|---|---|---|---|
customerId | string | Required | Google Ads customer ID (without dashes, e.g., 1234567890) |
level | string | Optional | Simulation resource level to query. One of: campaign, ad_group, bidding_strategy. Default: "campaign". |
campaignId | string | Optional | Optional campaign ID filter. Applies directly to campaign simulations and as campaign context for ad group simulations. |
adGroupId | string | Optional | Optional ad group ID filter for ad_group simulations. |
biddingStrategyId | string | Optional | Optional portfolio bidding strategy ID filter for bidding_strategy simulations. |
simulationStartDate | string | Optional | Optional minimum simulation start date YYYY-MM-DD. |
simulationEndDate | string | Optional | Optional maximum simulation end date YYYY-MM-DD. |
typeFilter | string | Optional | Optional SimulationType enum, e.g. BUDGET, TARGET_CPA, TARGET_ROAS, CPC_BID. |
modificationMethod | string | Optional | Optional SimulationModificationMethod enum, e.g. UNIFORM, SCALING, DEFAULT. |
limit | integer | Optional | Default: 1000. |
Calling itLink to this section
{
"name": "run_tool",
"arguments": {
"name": "google_ads_get_simulations",
"args": {
"customerId": "<string>"
}
}
}