Integrations#

See how an AI assistant can help with integrations 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.

List integrations#

List every integration provider Brandwave offers (Google Analytics and Search Console today; Mixpanel, PostHog, HubSpot, Bing, Clarity coming) with the organization’s connection state, the sources selected through each connection (site traffic, success events, search performance) and their sync status, and a coverage map of which evidence kinds currently have a live source.

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

Example prompt#

text

List all integrations in my organization.

Details to provide#

Name	Type	Required	Description
organizationId	`string (UUID)`	Required	Organization identifier.

What you'll get back#

Returns { data, _meta } with the result.

Disconnect integration#

Disconnect an integration provider, stopping every source it supplies (for Google: the GA4 property and Search Console site) and revoking stored credentials. Historical data already synced is retained.

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

Owner only

Example prompt#

text

Remove the integration.

Details to provide#

Name	Type	Required	Description
organizationId	`string (UUID)`	Required	Organization identifier.
provider	`'google' \| 'mixpanel' \| 'posthog' \| 'hubspot' \| 'bing'`	Required	Integration provider key.

What you'll get back#

Returns { data, _meta } with the result.

Remove integration source#

Remove one selected evidence source (site traffic, success events, or search performance) so it stops syncing, without disconnecting the provider. History is retained and the source can be reselected later.

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

Owner only

Example prompt#

text

Remove the integration source.

Details to provide#

Name	Type	Required	Description
organizationId	`string (UUID)`	Required	Organization identifier.
kind	`'site_traffic' \| 'success_events' \| 'search_performance'`	Required	Evidence a source provides: site_traffic (sessions and users), success_events (conversion events), search_performance (search impressions and clicks).

What you'll get back#

Returns { data, _meta } with the result.