`activities`#

Browse activities resource actions that can be discovered, described, and executed through the Brandwave MCP server.

Capability flow

Connect to the Brandwave MCP server via OAuth, then use discover-brandwave-capabilities, describe-brandwave-action, and execute-brandwave-action to work with these actions.

`list-activities`#

Retrieve a paginated list of activities for an organization.

Read-onlyIdempotent

Example prompt#

text

List all activities in my organization.

Parameters#

Name	Type	Required	Description
pageIndex	`integer`	Required	Zero-based page index for pagination.
pageSize	`integer`	Required	Number of items per page (1-100).
organizationId	`string (UUID)`	Required	Organization identifier.
searchTerm	`string`	—	Free-text search term to filter results (max 200 characters).
sortBy	`string`	—	Column name to sort by.
sortDirection	`'asc' \| 'desc'`	—	Sort direction: ascending or descending.
channel	`'instagram' \| 'youtube' \| 'tiktok' \| 'twitter' \| 'linkedin' \| 'reddit'`	—	Filter by social media platform.
creatorId	`string (UUID)`	—	Filter by creator identifier.
campaignId	`string (UUID)`	—	Filter by campaign identifier.

Response#

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

Underlying SDK method: bw.activities.list(params)

`count-activities`#

Get the total number of activities matching the given filters.

Read-onlyIdempotent

Example prompt#

text

How many activities do I have?

Parameters#

Name	Type	Required	Description
organizationId	`string (UUID)`	Required	Organization identifier.
channel	`'instagram' \| 'youtube' \| 'tiktok' \| 'twitter' \| 'linkedin' \| 'reddit'`	—	Filter by social media platform.
creatorId	`string (UUID)`	—	Filter by creator identifier.
campaignId	`string (UUID)`	—	Filter by campaign identifier.

Response#

Returns { count } with the total number of matching records.

Underlying SDK method: bw.activities.count(params)

`get-activity-stats`#

Aggregate statistics for activities matching the given filters.

Read-onlyIdempotent

Example prompt#

text

Show me the details for this activity stats.

Parameters#

Name	Type	Required	Description
organizationId	`string (UUID)`	Required	Organization identifier.
channel	`'instagram' \| 'youtube' \| 'tiktok' \| 'twitter' \| 'linkedin' \| 'reddit'`	—	Filter by social media platform.
creatorId	`string (UUID)`	—	Filter by creator identifier.
campaignId	`string (UUID)`	—	Filter by campaign identifier.
searchTerm	`string`	—	Free-text search term to filter results (max 200 characters).

Response#

Returns { data } with the result.

Underlying SDK method: bw.activities.stats(params)

`create-activity`#

Create a new activity with optional creator auto-linking.

Example prompt#

text

Create a new activity.

Parameters#

Name	Type	Required	Description
organizationId	`string (UUID)`	Required	Organization identifier.
channel	`'instagram' \| 'youtube' \| 'tiktok' \| 'twitter' \| 'linkedin' \| 'reddit'`	Required	Social media platform for this activity.
activity	`'instagram_story' \| 'instagram_post' \| 'instagram_reel' \| 'youtube_video' \| 'youtube_short' \| 'tiktok_video' \| 'twitter_post' \| 'linkedin_post' \| 'reddit_post'`	Required	Specific content type within a platform.
name	`string`	Required	Activity name or title (max 500 characters).
startAt	`string (ISO 8601) \| null`	—	When the activity was published or started.
endAt	`string (ISO 8601) \| null`	—	When the activity ended (e.g., story expiry).
creatorId	`string (UUID)`	—	Creator to auto-link to this activity.

Response#

Returns { data } with the result.

Underlying SDK method: bw.activities.create(params)

`update-activity`#

Update an activity's details, social media channel, content link, or metrics.

Example prompt#

text

Update the activity.

Parameters#

Name	Type	Required	Description
id	`string (UUID)`	Required	Activity identifier to update.
channel	`'instagram' \| 'youtube' \| 'tiktok' \| 'twitter' \| 'linkedin' \| 'reddit'`	—	Updated social media platform.
activity	`'instagram_story' \| 'instagram_post' \| 'instagram_reel' \| 'youtube_video' \| 'youtube_short' \| 'tiktok_video' \| 'twitter_post' \| 'linkedin_post' \| 'reddit_post'`	—	Updated content type.
name	`string`	Required	Updated activity name (max 500 characters).
startAt	`string (ISO 8601) \| null`	—	Updated start date.
endAt	`string (ISO 8601) \| null`	—	Updated end date.
contentHref	`string (URL) \| null`	—	URL to the original content (max 2,048 characters).
viewsCount	`integer \| null`	—	Manual view count override (non-negative integer).
likeCount	`integer \| null`	—	Manual like count override (non-negative integer).
replyCount	`integer \| null`	—	Manual reply count override (non-negative integer).

Response#

Returns { data } with the result.

Underlying SDK method: bw.activities.update(params)

Content link changes reset metrics

Changing the contentLink triggers a metric refresh. Previous metric snapshots are preserved but the latest values will update.

`delete-activity`#

Permanently delete an activity and its associated records.

Destructive

Example prompt#

text

Delete this activity.

Parameters#

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

Response#

Returns { data } with the result.

Underlying SDK method: bw.activities.delete(params)

Destructive action

Deleting an activity permanently removes all linked metrics, costs, creator associations, and notes. This action cannot be undone.

`connect-activity-content-link`#

Connect a social media post URL to an activity for automatic metric tracking.

Example prompt#

text

Connect the activity content link.

Parameters#

Name	Type	Required	Description
activityId	`string (UUID)`	Required	Activity identifier to connect the content link to.
platform	`'instagram' \| 'youtube' \| 'tiktok' \| 'twitter' \| 'linkedin' \| 'reddit'`	Required	Social media platform for this content.
contentUrl	`string`	Required	URL to the social media content (max 2,048 characters).

Response#

Returns { data } with the result.

Underlying SDK method: bw.activities.contentLink.connect(params)

Metric refresh

Connecting a content link triggers an immediate metric fetch for the linked post.

`disconnect-activity-content-link`#

Disconnect a content link from an activity, stopping automatic metric tracking.

Example prompt#

text

Remove the activity content link.

Parameters#

Name	Type	Required	Description
activityId	`string (UUID)`	Required	Activity identifier to disconnect the content link from.

Response#

Returns { data } with the result.

Underlying SDK method: bw.activities.contentLink.disconnect(params)

`list-activity-creators`#

List creators linked to an activity with pagination.

Read-onlyIdempotent

Example prompt#

text

List all activity creators in my organization.

Parameters#

Name	Type	Required	Description
pageIndex	`integer`	Required	Zero-based page index for pagination.
pageSize	`integer`	Required	Number of items per page (1-100).
organizationId	`string (UUID)`	Required	Organization identifier.
activityId	`string (UUID)`	Required	Activity identifier to list creators for.

Response#

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

Underlying SDK method: bw.activities.creators.list(params)

`count-activity-creators`#

Count the number of creators linked to an activity.

Read-onlyIdempotent

Example prompt#

text

How many activity creators do I have?

Parameters#

Name	Type	Required	Description
organizationId	`string (UUID)`	Required	Organization identifier.
activityId	`string (UUID)`	Required	Activity identifier to count creators for.

Response#

Returns { count } with the total number of matching records.

Underlying SDK method: bw.activities.creators.count(params)

`link-activity-creator`#

Associate a creator with an activity.

Example prompt#

text

Connect the activity creator.

Parameters#

Name	Type	Required	Description
activityId	`string (UUID)`	Required	Activity identifier to link.
creatorId	`string (UUID)`	Required	Creator identifier to link.

Response#

Returns { data } with the result.

Underlying SDK method: bw.activities.creators.link(params)

`unlink-activity-creator`#

Remove a creator association from an activity.

Destructive

Example prompt#

text

Remove the activity creator.

Parameters#

Name	Type	Required	Description
activityId	`string (UUID)`	Required	Activity identifier to unlink from.
creatorId	`string (UUID)`	Required	Creator identifier to unlink.

Response#

Returns { data } with the result.

Underlying SDK method: bw.activities.creators.unlink(params)

Cascading deletion

Unlinking a creator removes all cost records associated with that creator on this activity.

`create-activity-cost`#

Add a cost line item to an activity with amount and currency code.

Example prompt#

text

Create a new activity cost.

Parameters#

Name	Type	Required	Description
activityId	`string (UUID)`	Required	Activity identifier to add the cost to.
amount	`number`	Required	Cost amount (must be greater than zero, max 100M).
type	`string`	Required	Cost type label, e.g. "creator_fee", "production" (max 100 characters).
currency	`string`	Required	ISO 4217 currency code, e.g. "USD", "NZD" (exactly 3 characters).
description	`string \| null`	—	Optional description of this cost line item (max 1,000 characters).
creatorId	`string (UUID) \| null`	—	Creator this cost is attributed to.

Response#

Returns { data } with the result.

Underlying SDK method: bw.activities.costs.create(params)

Auto-linking

If the activity has exactly one linked creator, the cost is automatically attributed to that creator.

`update-activity-cost`#

Update a cost line item on an activity, including creator attribution.

Example prompt#

text

Update the activity cost.

Parameters#

Name	Type	Required	Description
id	`string (UUID)`	Required	Cost record identifier to update.
amount	`number`	—	Updated cost amount (must be greater than zero, max 100M).
type	`string`	—	Updated cost type label (max 100 characters).
description	`string \| null`	—	Updated description (max 1,000 characters).
creatorId	`string (UUID) \| null`	—	Updated creator attribution.

Response#

Returns { data } with the result.

Underlying SDK method: bw.activities.costs.update(params)

`delete-activity-cost`#

Remove a cost line item from an activity.

Destructive

Example prompt#

text

Delete this activity cost.

Parameters#

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

Response#

Returns { data } with the result.

Underlying SDK method: bw.activities.costs.delete(params)

`get-metric-confidence`#

Assess the statistical confidence of an activity's metrics.

Read-onlyIdempotent

Example prompt#

text

Show me the details for this metric confidence.

Parameters#

Name	Type	Required	Description
organizationId	`string (UUID)`	Required	Organization identifier.
startDate	`string \| null`	—	Start date for confidence calculation window.
endDate	`string \| null`	—	End date for confidence calculation window.

Response#

Returns { data } with the result.

Underlying SDK method: bw.activities.metrics.confidence(params)

`list-sparklines`#

Fetch sparkline chart data for one or more activities.

Read-onlyIdempotent

Example prompt#

text

List all sparklines in my organization.

Parameters#

Name	Type	Required	Description
activityIds	`Array<string (UUID)>`	Required	Array of activity identifiers to fetch sparkline data for.

Response#

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

Underlying SDK method: bw.activities.sparklines.list(params)

`get-activity`#

Retrieve a single activity by ID with full details.

Read-onlyIdempotent

Example prompt#

text

Show me the details for this activity.

Parameters#

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

Response#

Returns { data } with the result.

Underlying SDK method: bw.activities({ id })

activities#

list-activities#

Example prompt#

Parameters#

Response#

count-activities#

Example prompt#

Parameters#

Response#

get-activity-stats#

Example prompt#

Parameters#

Response#

create-activity#

Example prompt#

Parameters#

Response#

update-activity#

Example prompt#

Parameters#

Response#

delete-activity#

Example prompt#

Parameters#

Response#

connect-activity-content-link#

Example prompt#

Parameters#

Response#

disconnect-activity-content-link#

Example prompt#

Parameters#

Response#

list-activity-creators#

Example prompt#

Parameters#

Response#

count-activity-creators#

Example prompt#

Parameters#

Response#

link-activity-creator#

Example prompt#

Parameters#

Response#

unlink-activity-creator#

Example prompt#

Parameters#

Response#

create-activity-cost#

Example prompt#

Parameters#

Response#

update-activity-cost#

Example prompt#

Parameters#

Response#

delete-activity-cost#

Example prompt#

Parameters#

Response#

get-metric-confidence#

Example prompt#

Parameters#

Response#

list-sparklines#

Example prompt#

Parameters#

Response#

get-activity#

Example prompt#

Parameters#

Response#

`activities`#

`list-activities`#

`count-activities`#

`get-activity-stats`#

`create-activity`#

`update-activity`#

`delete-activity`#

`connect-activity-content-link`#

`disconnect-activity-content-link`#

`list-activity-creators`#

`count-activity-creators`#

`link-activity-creator`#

`unlink-activity-creator`#

`create-activity-cost`#

`update-activity-cost`#

`delete-activity-cost`#

`get-metric-confidence`#

`list-sparklines`#

`get-activity`#