Brand demand#

See how an AI assistant can help with brand demand 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 brand demand config#

Fetch the workspace Brand Demand configuration, including own brand, competitors, exact terms, markets, review state, and Search Console status.

Tool name: get_brand_demand_config. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.

Example prompt#

text

Show me the details for this brand demand config.

Details to provide#

Name	Type	Required	Description
workspaceId	`string (UUID)`	Required	Workspace identifier.

What you'll get back#

Returns { data, _meta } with the result.

Update brand demand config#

Update the active Brand Demand own brand, competitors, exact terms, and markets by replacing the configuration. Owners only.

Tool name: update_brand_demand_config. Protocol hints: readOnlyHint=false, destructiveHint=true, idempotentHint=true, openWorldHint=true.

Owner only

Example prompt#

text

Update the brand demand config.

Details to provide#

Name	Type	Required	Description
workspaceId	`string (UUID)`	Required	Workspace identifier.
ownBrand	`object`	Required
competitors	`Array<object>`	Required
markets	`Array<object>`	Required

What you'll get back#

Returns { data, _meta } with the result.

Get brand demand report#

Fetch 12 complete months of estimated branded-search demand and Share of Search for one market, with optional observed Search Console metrics reported separately.

Tool name: get_brand_demand_report. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.

Example prompt#

text

Show me the details for this brand demand report.

Details to provide#

Name	Type	Required	Description
workspaceId	`string (UUID)`	Required	Workspace identifier.
marketId	`string (UUID)`	—	Unique identifier (UUID v4).

What you'll get back#

Returns { data, _meta } with the result.

List brand demand moments#

List the months where searches for your own brand rose or fell well outside their usual level, each with what your team said ran that month or that it was not your marketing.

Tool name: list_brand_demand_moments. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.

Example prompt#

text

List all brand demand moments in my workspace.

Details to provide#

Name	Type	Required	Description
workspaceId	`string (UUID)`	Required	Workspace identifier.

What you'll get back#

Returns { data, _meta } with the result.

Answer brand demand moment#

Record what drove a month where your brand searches moved: link the activities or campaigns that ran, mark it as not your marketing, or reopen the question.

Tool name: answer_brand_demand_moment. Protocol hints: readOnlyHint=false, destructiveHint=true, idempotentHint=true, openWorldHint=false.

Example prompt#

text

Answer brand demand moment for my workspace.

Details to provide#

Name	Type	Required	Description
workspaceId	`string (UUID)`	Required	Workspace identifier.
month	`string`	Required	First day (YYYY-MM-01) of the month the moment covers.
answer	`'ran' \| 'external' \| 'reopen'`	Required	ran: link the activities or campaigns that ran that month. external: the movement was not driven by your marketing. reopen: clear the answer.
activityIds	`Array<string (UUID)>`	Required	Activities that ran that month, for the ran answer.
campaignIds	`Array<string (UUID)>`	Required	Campaigns that ran that month, for the ran answer.

What you'll get back#

Returns { data, _meta } with the result.

List search console sites#

List Search Console properties available to the authorized Google account.

Tool name: list_search_console_sites. Protocol hints: readOnlyHint=true, destructiveHint=false, idempotentHint=true, openWorldHint=false.

Owner only

Example prompt#

text

List all search console sites in my workspace.

Details to provide#

Name	Type	Required	Description
workspaceId	`string (UUID)`	Required	Workspace identifier.

What you'll get back#

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

Select search console site#

Select a Search Console property by site URL and start the initial branded-query backfill.

Tool name: select_search_console_site. Protocol hints: readOnlyHint=false, destructiveHint=true, idempotentHint=false, openWorldHint=false.

Owner only

Example prompt#

text

Select the search console site.

Details to provide#

Name	Type	Required	Description
workspaceId	`string (UUID)`	Required	Workspace identifier.
siteUrl	`string`	Required	Search Console property URL or domain identifier to select.

What you'll get back#

Returns { data, _meta } with the result.

Disconnect search console#

Disconnect Search Console without disconnecting Google Analytics or deleting historical observations.

Tool name: disconnect_search_console. Protocol hints: readOnlyHint=false, destructiveHint=true, idempotentHint=true, openWorldHint=false.

Owner only

Example prompt#

text

Remove the search console.

Details to provide#

Name	Type	Required	Description
workspaceId	`string (UUID)`	Required	Workspace identifier.

What you'll get back#

Returns { data, _meta } with the result.