costs#
Browse costs 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-costs#
List cost records across activities, including creator details.
Read-onlyIdempotent
Example prompt#
text
List all costs 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) | — | Filter by activity identifier. |
| 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.costs.list(params)
count-costs#
Count cost records with optional activity and creator filters.
Read-onlyIdempotent
Example prompt#
text
How many costs do I have?Parameters#
| Name | Type | Required | Description |
|---|---|---|---|
| organizationId | string (UUID) | Required | Organization identifier. |
| activityId | string (UUID) | — | Filter by activity identifier. |
| 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.costs.count(params)
list-cost-types#
Retrieve distinct cost type labels used across the organization.
Read-onlyIdempotent
Example prompt#
text
List all cost types 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. |
Response#
Returns { items, totalCount, facets } with paginated results.
Underlying SDK method: bw.costs.types.list(params)
Autocomplete
Use this endpoint to populate autocomplete suggestions when creating or editing cost records.