CommScore

Fill empty fields of a brand's voice guide and add audiences or terms. Never overwrites: fields that already have content are skipped and reported, and terms or audiences that already exist are kept. Use when saving content the user approved (from research_brand or their own guidelines). Only CommScore admins and members can change brands. Free.

update_brand_profile

Find words in a text that the brand avoids (with the brand's suggested replacement) and approved brand terms it uses. Use for a quick check of a draft's wording, or when the user asks whether a text uses the brand's terms. Whole-word, case-insensitive matching against the brand's term lists only: it doesn't judge tone, clarity or meaning (score_text does). Instant and doesn't use AI credits.

check_terminology

Add a new brand to the CommScore workspace from its name, website, language and country, plus any voice-guide fields you already have (for example from brand guidelines the user pasted). Use when the user wants to set up a brand in CommScore that list_brands doesn't show. Refuses an exact duplicate (same name and website). Only CommScore admins and members can create brands. Free; follow with research_brand to draft the voice guide from the website.

create_brand

Get a brand's voice and language guide: tone, core idea, values, style do's and don'ts, audiences, and terms to use or avoid. Use when the user asks you to write or edit a communication for the brand (read it before drafting), or asks how the brand should sound. Doesn't use AI credits.

get_brand_profile

List the user's own documents scored in the CommScore Office add-in (Word and Outlook, last 90 days), with first and latest overall score. Pass an id to get one document's rounds with pillar scores. Use when the user asks how a document they scored in Word or Outlook improved, or what they scored there recently. Scores made in this conversation aren't listed. Shows only the signed-in user's scores. Instant and doesn't use AI credits.

get_score_history

List the brands set up in the connected CommScore workspace, with their brand_id, website, industry, language and country. Use when you need a brand_id for another CommScore tool, or when the user asks which brands they have in CommScore. Brand names are not unique: if several brands share a name, use website and updated_at to tell them apart and confirm with the user which one they mean.

list_brands

Overwrite fields of a brand's voice guide, including its name. A list you pass (audiences, approved_terms, avoid_terms) replaces the whole existing list. Use when the user has confirmed they want existing content replaced; to add without overwriting, use update_brand_profile. Only CommScore admins and members can change brands. Free.

replace_brand_fields

Draft a brand's voice guide from its public website and web presence: values, customer charter, tone, writing principles, style examples, audiences, and terms to use or avoid. Saves nothing; returns suggestions for the user to review. Use when the user wants a brand's voice guide drafted, usually right after create_brand, or to fill gaps in an existing brand's guide. Only the brand name, website and country are sent to the web search. Uses the workspace's monthly AI credits and takes about 30 seconds.

research_brand

Rewrite a communication in the brand's voice, keeping its facts and purpose, and summarise what changed. Use when the user asks to improve, fix or rewrite a communication for the brand; after score_text, pass its suggested_focus as `focus`. Uses the workspace's monthly AI credits and takes up to about a minute. Not available when the workspace's subscription excludes rewriting.

rewrite_text

Score a communication against the brand on five pillars (clarity, certainty, structure/style/grammar, brand alignment, customer experience) from 1 to 5, with an overall score, a reading level and the top three things to fix. Use when the user asks to check, review, grade or compare a customer communication (email, letter, text message, notice, web or app copy, policy wording), or to check a draft you wrote for the brand before handing it over. To score a revised version, pass the previous result's draft.state as draft_state and the result shows the change since the last round. Uses the workspace's monthly AI credits and takes up to about a minute.

score_text