MMetadata /docs
⌘K
Docs/Tools/get_budget_group

get_budget_group

Get configuration and settings for a budget group (NOT performance data).

Read campaigns

Returns data. Calling it changes nothing, so it is safe in an unattended loop.

What it does

Get configuration and settings for a budget group (NOT performance data).

                KEYWORDS: budget, group, settings, configuration, details, allocation, campaigns

                WHEN TO USE:
                - "Show me the [group name] budget group settings/configuration"
                - "What campaigns are in the [group name] budget group?"
                - "What's the budget allocation for [group name]?"
                - Getting budget group metadata without performance metrics

                WHEN NOT TO USE:
                - Performance questions (spend, CPL, leads, conversions) → use budget_group_performance instead
                - Questions like "how did X perform" or "total spend for X" → use budget_group_performance instead

                NOTE: If the user is asking about performance metrics (spend, leads, CPL, etc.),
                use budget_group_performance directly - it accepts the name and handles ID lookup internally.

                Returns complete budget group information including campaigns, budget allocation, and settings.

Arguments

ArgumentTypeNotes
name string required The name of the budget group to search for. Example: 'Brand'

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":"get_budget_group","arguments":{"name":"<name>"}}}'

Response

Recorded with these arguments. Enum values are the first the tool's own schema declares; ids were fetched live from a list_ call immediately before.

arguments used
{
 "name": "[name redacted]"
}

Real, from the production server, in 445 ms. The full response was 44,357 bytes; this is the first part of it. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.

recorded response
{
 "startDate": "2026-09-01T00:00:00.000Z",
 "endDate": "2026-09-30T00:00:00.000Z",
 "monthlyCap": "[number redacted]",
 "monthlyCapFacebook": 0,
 "monthlyCapLinkedin": 0,
 "cplLinkedin": 0,
 "cplFacebook": 0,
 "totalBudget": "[number redacted]",
 "wizCampaignIds": [
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]",
  "[number redacted]"
  … truncated

Other campaigns tools:

All 160 tools · machine-readable index