reporting#

Browse reporting resource actions that can be discovered, described, and executed through the Brandwave MCP server.

Capability flow

Connect to the Brandwave MCP server via OAuth, then use discover-brandwave-capabilities, describe-brandwave-action, and execute-brandwave-action to work with these actions.

get-organization-metrics#

Fetch organization-level metrics including total costs, reach, engagement, conversions, and calculated CPM, CPE, CPA.

Read-onlyIdempotent

Example prompt#

text
Show me the details for this organization metrics.

Parameters#

NameTypeRequiredDescription
organizationIdstring (UUID)RequiredOrganization identifier.

Response#

Returns { data } with the result.

Underlying SDK method: bw.organizations.metrics.get(params)

get-organization-metrics-history#

Fetch organization metrics over time with a configurable lookback window.

Read-onlyIdempotent

Example prompt#

text
Show me the details for this organization metrics history.

Parameters#

NameTypeRequiredDescription
organizationIdstring (UUID)RequiredOrganization identifier.
daysBackintegerNumber of days of history to return (1-365).

Response#

Returns { items, totalCount, facets } with paginated results.

Underlying SDK method: bw.organizations.metrics.history(params)

get-campaign-metrics#

Fetch metrics for a single campaign including budget, cost, reach, engagement, conversions, and calculated CPM, CPE, CPA.

Read-onlyIdempotent

Example prompt#

text
Show me the details for this campaign metrics.

Parameters#

NameTypeRequiredDescription
organizationIdstring (UUID)RequiredOrganization identifier.
campaignIdstring (UUID)RequiredCampaign identifier to get metrics for.

Response#

Returns { data } with the result.

Underlying SDK method: bw.campaigns.metrics.get(params)

get-campaign-metrics-history#

Fetch campaign metrics over time with a configurable lookback window.

Read-onlyIdempotent

Example prompt#

text
Show me the details for this campaign metrics history.

Parameters#

NameTypeRequiredDescription
organizationIdstring (UUID)RequiredOrganization identifier.
campaignIdstring (UUID)RequiredCampaign identifier.
daysBackintegerNumber of days of history to return (1-365).

Response#

Returns { items, totalCount, facets } with paginated results.

Underlying SDK method: bw.campaigns.metrics.history(params)

get-creator-metrics#

Fetch metrics for a single creator including activity counts, follower totals, reach, engagement, conversions, and calculated CPM, CPE, CPA.

Read-onlyIdempotent

Example prompt#

text
Show me the details for this creator metrics.

Parameters#

NameTypeRequiredDescription
organizationIdstring (UUID)RequiredOrganization identifier.
creatorIdstring (UUID)RequiredCreator identifier to get metrics for.

Response#

Returns { data } with the result.

Underlying SDK method: bw.creators.metrics.get(params)

get-creator-metrics-history#

Fetch a creator's metrics over time with a configurable lookback window.

Read-onlyIdempotent

Example prompt#

text
Show me the details for this creator metrics history.

Parameters#

NameTypeRequiredDescription
organizationIdstring (UUID)RequiredOrganization identifier.
creatorIdstring (UUID)RequiredCreator identifier.
daysBackintegerNumber of days of history to return (1-365).

Response#

Returns { items, totalCount, facets } with paginated results.

Underlying SDK method: bw.creators.metrics.history(params)

get-activity-metrics#

Fetch metrics for a single activity including reach, engagement, cost, conversions, and calculated CPM, CPE, CPA.

Read-onlyIdempotent

Example prompt#

text
Show me the details for this activity metrics.

Parameters#

NameTypeRequiredDescription
organizationIdstring (UUID)RequiredOrganization identifier.
activityIdstring (UUID)RequiredActivity identifier to get metrics for.

Response#

Returns { data } with the result.

Underlying SDK method: bw.activities.metrics.get(params)

get-activity-metrics-history#

Fetch an activity's metrics over time with a configurable lookback window.

Read-onlyIdempotent

Example prompt#

text
Show me the details for this activity metrics history.

Parameters#

NameTypeRequiredDescription
organizationIdstring (UUID)RequiredOrganization identifier.
activityIdstring (UUID)RequiredActivity identifier.
daysBackintegerNumber of days of history to return (1-365).

Response#

Returns { items, totalCount, facets } with paginated results.

Underlying SDK method: bw.activities.metrics.history(params)