Creators#

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

Retrieve a paginated list of creators for a workspace, ordered by name, totals, or efficiency.

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

Example prompt#

text

List all creators 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' \| 'createdAt' \| 'activitiesCount' \| 'totalFollowersCount' \| 'impressions' \| 'engagement' \| 'spend' \| 'cpe' \| 'cpm'`	—	Creator 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.
activityId	`string (UUID)`	—	Filter by activity identifier.
role	`'person' \| 'community' \| 'brand_partner' \| 'own_brand'`	—	Filter by creator role. Creator lists leave out your own brand unless role is own_brand.

What you'll get back#

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

Get creator stats#

Aggregate statistics for creators matching the given filters.

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

Example prompt#

text

Give me a summary of my creator performance.

Details to provide#

Name	Type	Required	Description
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.
workspaceId	`string (UUID)`	Required	Workspace identifier.
activityId	`string (UUID)`	—	Filter by activity identifier.
role	`'person' \| 'community' \| 'brand_partner' \| 'own_brand'`	—	Filter by creator role. Creator lists leave out your own brand unless role is own_brand.
searchTerm	`string`	—	Free-text search term to filter results (max 200 characters).

What you'll get back#

Returns { data, _meta } with the result.

Get creator#

Retrieve a single creator by ID with full details and social accounts.

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

Example prompt#

text

Show me the details for this creator.

Details to provide#

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

What you'll get back#

Returns { data, _meta } with the result.

Create creator#

Create a new creator (influencer) within a workspace. Required: workspaceId, name. Optional: email, role (person/community/brand_partner), country (2-letter ISO code), notes.

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

Example prompt#

text

Create a new creator.

Details to provide#

Name	Type	Required	Description
workspaceId	`string (UUID)`	Required	Workspace identifier.
name	`string`	Required	Creator display name.
email	`string \| null`	—	Creator contact email.
role	`'person' \| 'community' \| 'brand_partner' \| null`	—	Creator role: "person", "community", or "brand_partner".
country	`string \| null`	—	Two-letter ISO 3166-1 country code.
notes	`string \| null`	—	Private notes about this creator (max 2,000 characters).

What you'll get back#

Returns { data, _meta } with the result.

Open your brand#

Get the record for your own brand as a poster, creating it the first time. Connect your brand's own social accounts to it and Brandwave adds each new post as an activity posted by your brand. Link it to an activity to record something your brand posted itself. It never appears in creator lists unless you filter by the own_brand role.

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

Example prompt#

text

Open your brand for my workspace.

Details to provide#

Name	Type	Required	Description
workspaceId	`string (UUID)`	Required	Workspace whose own brand to open.

What you'll get back#

Returns { data, _meta } with the result.

Update creator#

Update a creator profile including role, country, and private notes.

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

Example prompt#

text

Update the creator.

Details to provide#

Name	Type	Required	Description
id	`string (UUID)`	Required	Creator identifier to update.
name	`string`	—	Updated creator name (1-255 characters).
email	`string \| null`	—	Updated contact email.
role	`'person' \| 'community' \| 'brand_partner' \| null`	—	Updated role: "person", "community", or "brand_partner".
country	`string \| null`	—	Updated two-letter ISO 3166-1 country code.
notes	`string \| null`	—	Updated private notes (max 2,000 characters).

What you'll get back#

Returns { data, _meta } with the result.

Delete creator#

Permanently delete a creator and all associated data.

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

Example prompt#

text

Delete this creator.

Details to provide#

Name	Type	Required	Description
id	`string (UUID)`	Required	Creator identifier to delete.

What you'll get back#

Returns { data, _meta } with the result.

This changes data

Deleting a creator removes all social account links, activity associations, and notes. This action cannot be undone.

Add a public Instagram, YouTube, TikTok, X, LinkedIn or Reddit account to an existing creator by profile URL or username, and track the creator's public metrics.

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

Example prompt#

text

Connect this creator’s Instagram account.

Details to provide#

Name	Type	Required	Description
creatorId	`string (UUID)`	Required	Creator identifier to connect the account to.
platform	`'instagram' \| 'youtube' \| 'tiktok' \| 'twitter' \| 'linkedin' \| 'reddit'`	Required	Social media platform.
profileUrl	`string`	Required	Profile URL or username for the social media account (max 2,048 characters).

What you'll get back#

Returns { data, _meta } with the result.

Supported platforms

Pass a platform field: 'instagram', 'youtube', 'tiktok', 'twitter', 'linkedin', or 'reddit'.

Disconnect a social media account from a creator.

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

Example prompt#

text

Disconnect this social account from the creator.

Details to provide#

Name	Type	Required	Description
creatorId	`string (UUID)`	Required	Creator identifier to disconnect the account from.
accountId	`string (UUID)`	Required	Social media account identifier to disconnect.
platform	`'instagram' \| 'youtube' \| 'tiktok' \| 'twitter' \| 'linkedin' \| 'reddit'`	Required	Social media platform.

What you'll get back#

Returns { data, _meta } with the result.

Get creator metrics#

Fetch metrics for a single creator including activity counts, follower totals, impressions, engagement, spend, CPM, and CPE.

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

Example prompt#

text

How is this creator performing?

Details to provide#

Name	Type	Required	Description
workspaceId	`string (UUID)`	Required	Workspace identifier.
creatorId	`string (UUID)`	Required	Creator identifier to get metrics for.

What you'll get back#

Returns { data, _meta } with the result.

Get creator metrics history#

Fetch a creator's follower count, impressions, engagement, spend, CPM, and CPE over time with a configurable lookback window.

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

Example prompt#

text

Show me this creator’s performance over time.

Details to provide#

Name	Type	Required	Description
workspaceId	`string (UUID)`	Required	Workspace identifier.
creatorId	`string (UUID)`	Required	Creator identifier.
daysBack	`integer`	—	Number of days of history to return (1-365).

What you'll get back#

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

Creators#

List creators#

Example prompt#

Details to provide#

What you'll get back#

Get creator stats#

Example prompt#

Details to provide#

What you'll get back#

Get creator#

Example prompt#

Details to provide#

What you'll get back#

Create creator#

Example prompt#

Details to provide#

What you'll get back#

Open your brand#

Example prompt#

Details to provide#

What you'll get back#

Update creator#

Example prompt#

Details to provide#

What you'll get back#

Delete creator#

Example prompt#

Details to provide#

What you'll get back#

Link creator social profile#

Example prompt#

Details to provide#

What you'll get back#

Disconnect social account#

Example prompt#

Details to provide#

What you'll get back#

Get creator metrics#

Example prompt#

Details to provide#

What you'll get back#

Get creator metrics history#

Example prompt#

Details to provide#

What you'll get back#