# get_brand_usage

> Get a brand's usage with Wavegrain's MCP server: the get_brand_usage tool needs the read permission. Inputs, outputs and an example call.

> Index of these docs: https://wavegrain.com/developers/llms.txt

**Get a brand's usage.** Permission: `read`. Read-only: changes nothing.

One brand's slideshows, posts, performance, what works and credits spent in the last 1 to 730 days.

## Inputs

| Input | Type | Required | Notes |
| --- | --- | --- | --- |
| `brandId` | string | no | Default: the active brand. up to 200 characters |
| `days` | integer | no | How many past days to count, up to today. 1 to 730, default 30 |

The fields inside an object or a list are in the JSON Schema at [/developers/mcp-tools.json](/developers/mcp-tools.json).

## Returns

| Field | Type | Notes |
| --- | --- | --- |
| `brandId` | string | The brand counted. |
| `brandName` | string | Its name. |
| `since` | string | The start of the counted days, ISO 8601. |
| `slideshows` | object | Slideshow counts. |
| `posts` | object[] | Posts per network in the window. |
| `performance` | object | Sums of the networks' own counts; null means no network reported it, not zero. |
| `credits` | object | Credits in the window. |
| `groups` | object[] | Each account group of the brand over the same days, as on the Analytics page: a post counts in the group it went out for, an account in every group it sits in. previous is the same number of days before. |
| `insights` | object | What works, as on the Analytics page: median views by format, AI creator, slides, photo or video and network, against the usual post (lift 2 is twice its views). A value needs 3 posts; usual is null below that. |
| `note` | string | How to read the numbers. |

## Example call

Send it to `POST https://wavegrain.com/api/mcp` with an access key that has the `read` permission; [Authentication](/developers/authentication) shows how to make one.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_brand_usage",
    "arguments": {}
  }
}
```

## Related tools

- [`get_tailored_slideshow`](/developers/mcp-tools/get_tailored_slideshow): Get a tailored slideshow
- [`list_tailored_versions`](/developers/mcp-tools/list_tailored_versions): List tailored versions
- [`plan_week`](/developers/mcp-tools/plan_week): Plan a week of posts
- [`list_accounts`](/developers/mcp-tools/list_accounts): List accounts and groups
- [`get_connect_link`](/developers/mcp-tools/get_connect_link): Get a link to connect an account
- [`get_post_status`](/developers/mcp-tools/get_post_status): Get a post's status
- [All 79 tools](/developers/mcp-tools)
