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.
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.
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 shows how to make one.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_brand_usage",
"arguments": {}
}
}
Related tools
get_tailored_slideshow: Get a tailored slideshowlist_tailored_versions: List tailored versionsplan_week: Plan a week of postslist_accounts: List accounts and groupsget_connect_link: Get a link to connect an accountget_post_status: Get a post's status- All 79 tools
Something wrong or missing? Write to support@wavegrain.com.