Media providers#

See how an AI assistant can help with media providers 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 media providers#

List providers that organized, published, sold, or delivered marketing activity, ordered by any column.

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

Example prompt#

text

List all media providers in my workspace.

Details to provide#

Name	Type	Required	Description
pageIndex	`integer`	Required	Zero-based page index for pagination.
pageSize	`integer`	Required	Number of items per page (1-100).
workspaceId	`string (UUID)`	Required	Workspace identifier.
searchTerm	`string`	—	Free-text search term to filter results (max 200 characters).
sortBy	`'name' \| 'websiteUrl' \| 'createdAt' \| 'activityCount' \| 'spend' \| 'impressions'`	—	Media provider field to sort by.
sortDirection	`'asc' \| 'desc'`	—	Sort direction: ascending or descending.
dateFrom	`string`	—	Earliest date to include, as YYYY-MM-DD in the workspace timezone.
dateTo	`string`	—	Latest date to include, as YYYY-MM-DD in the workspace timezone. Use the same date as dateFrom for a single day.

What you'll get back#

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

Create media provider#

Create a reusable media provider with an optional website and private notes for provider-delivered activities.

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

Example prompt#

text

Create a new media provider.

Details to provide#

Name	Type	Required	Description
workspaceId	`string (UUID)`	Required	Unique identifier (UUID v4).
name	`string`	Required	Media provider name.
websiteUrl	`string (URL) \| null`	—	Public website URL for the media provider.
notes	`string \| null`	—	Private notes about the media provider.

What you'll get back#

Returns { data, _meta } with the result.

Get media provider stats#

Get spend, delivery coverage, weighted CPM, and attention statistics for media providers.

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

Example prompt#

text

Show me the details for this media provider stats.

Details to provide#

Name	Type	Required	Description
workspaceId	`string (UUID)`	Required	Workspace identifier.
searchTerm	`string`	—	Free-text search term to filter results (max 200 characters).
dateFrom	`string`	—	Earliest date to include, as YYYY-MM-DD in the workspace timezone.
dateTo	`string`	—	Latest date to include, as YYYY-MM-DD in the workspace timezone. Use the same date as dateFrom for a single day.

What you'll get back#

Returns { data, _meta } with the result.

Update media provider#

Update a media provider name, website, or private notes.

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

Example prompt#

text

Update the media provider.

Details to provide#

Name	Type	Required	Description
id	`string (UUID)`	Required	Unique identifier (UUID v4).
name	`string`	—	Updated display name (1-255 characters).
websiteUrl	`string (URL) \| null`	—	Updated public website URL for the media provider.
notes	`string \| null`	—	Updated private notes about the media provider.

What you'll get back#

Returns { data, _meta } with the result.

Delete media provider#

Delete a media provider that has no active delivered activities linked to it.

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

Example prompt#

text

Delete this media provider.

Details to provide#

Name	Type	Required	Description
id	`string (UUID)`	Required	Unique identifier (UUID v4).

What you'll get back#

Returns { data, _meta } with the result.

Get media provider#

Get a media provider with delivered activity, spend, and impression totals.

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

Example prompt#

text

Show me the details for this media provider.

Details to provide#

Name	Type	Required	Description
id	`string (UUID)`	Required	Media provider identifier.

What you'll get back#

Returns { data, _meta } with the result.