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

InputTypeRequiredNotes
brandIdstringnoDefault: the active brand. up to 200 characters
daysintegernoHow 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

FieldTypeNotes
brandIdstringThe brand counted.
brandNamestringIts name.
sincestringThe start of the counted days, ISO 8601.
slideshowsobjectSlideshow counts.
postsobject[]Posts per network in the window.
performanceobjectSums of the networks' own counts; null means no network reported it, not zero.
creditsobjectCredits in the window.
groupsobject[]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.
insightsobjectWhat 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.
notestringHow 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": {}
  }
}

Something wrong or missing? Write to support@wavegrain.com.