---
title: "budget_group_performance. Metadata MCP tool reference"
url: https://metadata.io/developers/tools/budget_group_performance
description: "Performance statistics for a specific budget group by name. Read tool on the Metadata MCP server, with its full JSON Schema and a real recorded response."
source: metadata.io
---

# budget_group_performance

Performance statistics for a specific budget group by name.

Read [analytics](https://metadata.io/developers/tools/#cat-analytics)

## What it does

## Arguments

| Argument | Type |   | Notes |
|---|---|---|---|
| `budget_group_name` | string | required | Name of the budget group to analyze (required). The tool will automatically look up the budget group ID. Example: 'Brand Awareness', 'ToFu', 'Lead Gen Q4' |
| `startDate` | string |   | Start date for analysis in ISO 8601 format (YYYY-MM-DDTHH:mm:ss.SSSZ, e.g., '2025-01-01T00:00:00.000Z'). Optional - if not provided, no start date filter is applied. |
| `endDate` | string |   | End date for analysis in ISO 8601 format (YYYY-MM-DDTHH:mm:ss.SSSZ, e.g., '2025-12-15T23:59:59.999Z'). Optional - if not provided, no end date filter is applied. |
| `excludeExperimentName` | string |   | Experiment name to exclude from results. Useful for filtering out specific experiments from the analysis. |
| `page` | integer |   | Page number for pagination (0-based). Use for paginating through large result sets. |
| `size` | integer |   | Number of experiments per page. Default is 10. Use larger values (up to 10000) for comprehensive analysis — pull the whole set rather than a sample. |
| `sort` | string |   | Sort criteria for experiments. Format: field,field,direction. Examples: 'experimentId,name,asc', 'spent,desc', 'cpl,asc' |

## Request

**Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

## 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.

Real, from the production server, in **2968 ms**. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.

## Related

Other analytics tools:

- [account_funnel_reports](https://metadata.io/developers/tools/account_funnel_reports) Read
- [account_level_stats](https://metadata.io/developers/tools/account_level_stats) Read
- [account_list_performance](https://metadata.io/developers/tools/account_list_performance) Read
- [deep_funnel_stats](https://metadata.io/developers/tools/deep_funnel_stats) Read
- [demographic_country_stats](https://metadata.io/developers/tools/demographic_country_stats) Read
- [experiment_performance_stats](https://metadata.io/developers/tools/experiment_performance_stats) Read
- [get_account_opportunities_insights](https://metadata.io/developers/tools/get_account_opportunities_insights) Read
- [get_account_summary_insights](https://metadata.io/developers/tools/get_account_summary_insights) Read

[Browse the tool catalog](https://metadata.io/developers/tools/) · [machine-readable index](https://metadata.io/developers/tools.json)