Reporting#

See how an AI assistant can help with reporting in Brandwave, including example prompts and the details it may ask for.

Using your AI assistant

Connect to the Brandwave MCP server, then ask your AI assistant in natural language. It will choose the right Brandwave task and ask for any details it needs.

Get organization metrics#

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

Reads dataSafe to repeat

Example prompt#

text
Show me the details for this organization metrics.

Details to provide#

NameTypeRequiredDescription
organizationIdstring (UUID)RequiredOrganization identifier.

What you'll get back#

Returns { data } with the result.

Get organization metrics history#

Fetch organization metrics over time with a configurable lookback window.

Reads dataSafe to repeat

Example prompt#

text
Show me the details for this organization metrics history.

Details to provide#

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

What you'll get back#

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

Get campaign metrics#

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

Reads dataSafe to repeat

Example prompt#

text
Show me the details for this campaign metrics.

Details to provide#

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

What you'll get back#

Returns { data } with the result.

Get campaign metrics history#

Fetch campaign metrics over time with a configurable lookback window.

Reads dataSafe to repeat

Example prompt#

text
Show me the details for this campaign metrics history.

Details to provide#

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

What you'll get back#

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

Get creator metrics#

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

Reads dataSafe to repeat

Example prompt#

text
Show me the details for this creator metrics.

Details to provide#

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

What you'll get back#

Returns { data } with the result.

Get creator metrics history#

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

Reads dataSafe to repeat

Example prompt#

text
Show me the details for this creator metrics history.

Details to provide#

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

What you'll get back#

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

Get activity metrics#

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

Reads dataSafe to repeat

Example prompt#

text
Show me the details for this activity metrics.

Details to provide#

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

What you'll get back#

Returns { data } with the result.

Get activity metrics history#

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

Reads dataSafe to repeat

Example prompt#

text
Show me the details for this activity metrics history.

Details to provide#

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

What you'll get back#

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