MMetadata /docs
Docs/Tools/update_experiments_daily_budgets

update_experiments_daily_budgets

Update daily budget allocations for one or more experiments in the Metadata platform.

Destructive campaigns

Deletes, archives, launches or moves budget. Do not give an agent this one without a human gate.

What it does

Update daily budget allocations for one or more experiments in the Metadata platform.

                KEYWORDS: experiment, budget, daily, update, change, adjust, spending, allocation, modify

                WHEN TO USE:
                - User wants to "change the daily budget for experiment X"
                - User asks to "adjust daily budget for experiments A, B, C"
                - User requests to "update experiment budgets"
                - User wants to "allocate more budget to experiment Y"
                - User asks to "set daily budget to X for multiple experiments"

                PURPOSE:
                This tool allows you to adjust the daily budget amount for active experiments.
                The daily budget controls how much money each experiment can spend per day.

                REQUIRED PARAMETERS:
                - budgets: A dictionary mapping experiment IDs to their new daily budget values

                BUDGET VALUE FORMAT:
                Budget values can be provided as:
                - Strings with comma separator (European format): "100,50" → 100.50
                - Strings with dot separator (US format): "100.50" → 100.50
                - Numbers: 100, 100.5, 100.50
                - All values are automatically converted to 2 decimal places

                INPUT EXAMPLES:
                - Single experiment: {"budgets": {"12345": "100.50"}}
                - Multiple experiments: {"budgets": {"12345": 100.50, "12346": "150,75", "12347": 200}}

                INTEGRATION WITH OTHER TOOLS:
                - Use search_experiments to find the experiment IDs to update the daily budget.

Arguments

ArgumentTypeNotes
budgets object required Dictionary mapping experiment IDs to new daily budget values. Keys are experiment IDs (integers or strings), values are budget amounts (numbers or strings with comma/dot separators). Example: {'12345': 100.50, '12346': '150,75'}

Request

curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
  -H "Authorization: $METADATA_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"update_experiments_daily_budgets","arguments":{"budgets":{}}}}'

Response

No recorded response. This tool can delete, archive, launch or move budget, so it is never executed to build these docs. The request above is still the exact shape to send. Nothing on this page is invented.

Other campaigns tools:

All 160 tools · machine-readable index