TraceeDocs

Tools

brand

Brand

MCP toolcan change or delete

The workspace's brand: the company, its products, who it sells to, how it sounds and how it looks, plus the brand rules every draft is checked against.

Actions

get

The brand profile, the brand rules (tone, banned phrases, notes) and the guardrails. Read it before writing anything.

RESTGET/brand·CLItracee brand get

learn

learn url=<website>

Learn the brand in depth and save it as the brand profile, replacing the current one: about ten key pages of the site (about, products, pricing, customers, blog), the company's past posts (LinkedIn, X, YouTube, and what went out through Tracee) and what others post about it, and its logo, product shots and team pictures, saved to the library with their roles. It runs in the background for one to three minutes; if it isn't done when the call returns, follow it with action=learn_status run_id. If someone already edited the profile, ask before replacing it.

RESTPOST/brand/learn·CLItracee brand learn

learn_status

learn_status run_id

Wait for a learning run and see its steps; returns the new profile once done.

RESTGET/brand/learn/{run_id}·CLItracee brand learn-status <run_id>

update

Fields={...}: change fields (name, website, tagline, oneLiner, category, logo, colors, fonts, products, audience, valueProps, proofPoints, contentPillars, voice, socials). A list you pass replaces that whole list.

RESTPATCH/brand·CLItracee brand update

add

add list=<field> item=<value>

Add one item to a list (products, valueProps, proofPoints, contentPillars, colors, fonts, audience.industries, audience.buyerRoles, audience.painPoints, voice.adjectives, voice.avoid). A product is {name, summary, features}, a colour {role, hex}, a font {family, role: heading|body} where family is a Google Font Tracee knows (an unknown one is refused with the list); the rest are text.

RESTPOST/brand/lists/{list}·CLItracee brand list add <list>

remove

remove list=<field> item=<text, product name or hex> (or index=<n>)

Remove one item.

RESTPOST/brand/lists/{list}/remove·CLItracee brand list remove <list>

clear

Delete the brand profile. Brand rules stay.

RESTDEL/brand·CLItracee brand clear

add_asset

add_asset url=<https image or video> role=<logo|product|people|social|other> [name] [alt_text]

Add one to the brand.

RESTPOST/brand/assets·CLItracee brand assets add

tag_asset

tag_asset media_id [role] [name] [alt_text]

Change an asset's role, name or alt text; media action=list shows the whole library.

RESTPATCH/brand/assets/{media_id}·CLItracee brand assets update <media_id>

remove_asset

remove_asset media_id

Take it out of the brand (it stays in the library). Deleting files is for people, on the Brand page.

RESTDEL/brand/assets/{media_id}·CLItracee brand assets remove <media_id>

Assets (logos, product shots, people, social images) are media in the workspace library; get lists them with their media_id, which posts can attach.

Brand rules are changed only by people, on the Brand page; guardrails in Settings.

Inputs

Every call takes action and the fields that action names above.

  • actionstringdefault: "get"

    What to do: get, learn, learn_status, update, add, remove, clear, add_asset, tag_asset or remove_asset. Each is described in the tool description.

    Available options:getlearnlearn_statusupdateaddremoveclearadd_assettag_assetremove_asset

  • urlstring

    For learn: the company's website. For add_asset: a public https image or video

    up to 1,000 characters

  • run_idstring

    For learn_status, from action=learn

    uuid

  • media_idstring

    For tag_asset and remove_asset. From media action=list (or the media_id media action=add / generate_image returns).

    uuid

  • rolestring

    For add_asset and tag_asset

    Available options:logoproductpeoplesocialother

  • namestring

    For add_asset and tag_asset

    up to 200 characters

  • alt_textstring

    For add_asset and tag_asset

    up to 500 characters

  • fieldsobject

    For update

  • liststring

    For add and remove

    Available options:productsvaluePropsproofPointscontentPillarscolorsfontsaudience.industriesaudience.buyerRolesaudience.painPointsvoice.adjectivesvoice.avoid

  • itemstring | object

    For add: the item. For remove: its text, product name or hex

  • indexinteger

    For remove, instead of item