Cost categories#

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

List reusable cost categories with usage counts and recorded spend.

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

Example prompt#

text

List all cost categories in my organization.

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).
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.

What you'll get back#

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

Create cost category#

Create a reusable organization-owned cost category while adding or editing costs.

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

Example prompt#

text

Create a new cost category.

Details to provide#

Name	Type	Required	Description
organizationId	`string (UUID)`	Required	Organization identifier.
name	`string`	Required	Reusable cost category name.

What you'll get back#

Returns { data, _meta } with the result.

Update cost category#

Update a reusable cost category name across every cost that uses it.

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

Example prompt#

text

Update the cost category.

Details to provide#

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

What you'll get back#

Returns { data, _meta } with the result.

Delete cost category#

Permanently delete an unused cost category; referenced categories are blocked.

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

Example prompt#

text

Delete this cost category.

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.