> ## Documentation Index > Fetch the complete documentation index at: https://docs.adsmcp.si/llms.txt > Use this file to discover all available pages before exploring further. # optimize_google_budget_allocation > Propose daily budgets across the account's enabled campaigns: a deterministic greedy move from weak to strong campaigns (ROAS, or 1/CPA without conversion value; budget-limited campaigns weighted up), > [!NOTE] > > **Read-only.** Runs right away and changes nothing in your ad accounts. It still needs a connected platform (check `get_connections_status`) and counts as one tool call. Propose daily budgets across the account's enabled campaigns: a deterministic greedy move from weak to strong campaigns (ROAS, or 1/CPA without conversion value; budget-limited campaigns weighted up), within max\_change\_percentage and min\_daily\_budget, PAUSE for zero-conversion campaigns spending over 2× their CPA target. Read-only: it changes nothing. To apply it, stage update\_google\_campaign\_budget / pause\_google\_campaign per row and approve decreases and pauses before increases. Shared budgets are reported, never moved. **Platform:** Google Ads · **Type:** Read **Also accepted as:** `optimize_budget_allocation`. These older names run this same tool. ## How to call it * **MCP:** on `https://mcp.adsmcp.si/mcp`, run it through the `google_ads_read` tool with `{"action": "execute", "tool_name": "optimize_google_budget_allocation", "arguments": { ... }}`, or call `optimize_google_budget_allocation` by name. `search_tools` finds it and `get_tool_schema` returns its arguments; `https://mcp.adsmcp.si/mcp/flat` lists every tool by name. * **REST:** `POST https://mcp.adsmcp.si/api/v1/tools/optimize_google_budget_allocation/execute` with `Authorization: Bearer sk_live_...` and a JSON body `{"platform": "google", "arguments": { ... }}`. The arguments are listed below; they are exactly the tool's input schema. ## OpenAPI ````yaml api-reference/openapi.json POST /api/v1/tools/optimize_google_budget_allocation/execute openapi: 3.1.0 info: title: ADSMCP REST API version: 0.1.0 description: >- ADSMCP REST API: every public ADSMCP tool as POST /api/v1/tools/{name}/execute. Generated from the ADSMCP code (the service serves the same document at GET /api/v1/openapi.json). Changes to ad accounts are staged for approval by a person on the ADSMCP dashboard; nothing in this API can approve them. servers: - url: https://mcp.adsmcp.si description: ADSMCP MCP and REST service security: [] paths: /api/v1/tools/optimize_google_budget_allocation/execute: post: tags: - google summary: >- Propose daily budgets across the account's enabled campaigns: a deterministic greedy move from weak to strong campaigns (ROAS, or 1/CPA without conversion value; budget-limited campaigns weighted up), within max_change_percentage and min_daily_budget, PAUSE for zero-conversion campaigns spending over 2× their CPA target. Read-only: it changes nothing. To apply it, stage update_google_campaign_budget / pause_google_campaign per row and approve decreases and pauses before increases. Shared budgets are reported, never moved. description: >- Propose daily budgets across the account's enabled campaigns: a deterministic greedy move from weak to strong campaigns (ROAS, or 1/CPA without conversion value; budget-limited campaigns weighted up), within max_change_percentage and min_daily_budget, PAUSE for zero-conversion campaigns spending over 2× their CPA target. Read-only: it changes nothing. To apply it, stage update_google_campaign_budget / pause_google_campaign per row and approve decreases and pauses before increases. Shared budgets are reported, never moved. Use this when you need that result and get_connections_status already shows the platform as connected. Read tools run without the approval queue. operationId: execute_optimize_google_budget_allocation parameters: - name: Authorization in: header required: true schema: type: string description: Bearer token - name: Idempotency-Key in: header required: false schema: type: string requestBody: required: false content: application/json: schema: type: object properties: platform: type: string default: google arguments: type: object properties: account_id: type: string customer_id: type: string description: Docs name for account_id (dashes allowed). login_customer_id: type: string total_budget: type: number exclusiveMinimum: 0 description: >- Monthly total in account currency (daily target = total_budget / 30.4). Optional: omitted keeps today's total and only moves money between campaigns. lookback_days: type: integer enum: - 7 - 30 - 60 - 90 - 120 start_date: type: string description: >- YYYY-MM-DD, account time zone, inclusive. Use with end_date; overrides lookback_days. end_date: type: string description: >- YYYY-MM-DD, account time zone, inclusive. Use with start_date. target_roas: type: number exclusiveMinimum: 0 description: >- Override; else the kpi target, else the period ROAS, else 1.0. A campaign below it never receives budget. max_change_percentage: type: number minimum: 0 maximum: 1 description: Per-campaign change limit (default 0.5). min_daily_budget: type: number minimum: 0 description: Account currency (default 5). additionalProperties: false additionalProperties: false responses: '200': description: Tool execution result. content: application/json: schema: $ref: '#/components/schemas/ExecuteToolResponse' '400': description: Invalid JSON input. '401': description: Authentication error. security: - bearerAuth: [] components: schemas: ExecuteToolResponse: type: object properties: ok: type: boolean platform: type: string tool: type: string data: {} error: anyOf: - type: 'null' - $ref: '#/components/schemas/ErrorResponse' mcp_response: {} required: - ok - platform - tool - error - mcp_response additionalProperties: false ErrorResponse: type: object properties: code: {} message: type: string details: {} required: - message additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API token ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.