MCP Tools Reference Brand Kit OS exposes 40 tools through its MCP server, covering reads, writes, AI generation, and knowledge file management. This page lists every tool, its required scope, and its parameters.
Authentication Tools are accessible via two authentication methods: OAuth 2.0 (Remote Connector): No API key needed — Claude authenticates via your Brand Kit OS account. All scopes granted by default.
API Key: For Cursor, Claude Code, and other MCP clients — pass your key in the header. Scopes are key specific — write tools require an API key minted with the matching write scope.
Scopes | Scope | Grants | | | | | | All / brand kit tools (default) | | | All , , , and brand kit tools | | | | Read Tools | Tool | Description | Parameters | | | | | | | Lists all brand kits the user has access to | none | | | Returns all sections of a brand kit in a single call — core, personality, expression, audience, governance, products, personas, competitors, visuals, SEO | | | | Compact overview (~500 tokens) — ideal for quick context loading | | | | Reports per section completion percentages and missing fields | | | | Optimized agent ready briefing combining identity, voice, and guardrails | | | | Mission, vision, story, promises | | | | Brand values, principles, traits, moods | | | | Tone of voice, verbal style, terminology, archetypes | | | | Target audience personas with demographics, motivations, pain points | | | | Behavioral constraints, writing rules, compliance notes | | | | Products/services with descriptions, pricing, USPs | | | | AI personas with roles, rules, tone overrides | | | | Competitor analysis data | | | | SEO keywords, tags, suggested keywords | | | | Connected social profiles per brand kit | | | | Logo asset metadata for a brand kit | | | | A single logo asset by id | | | | Lists logo assets for a brand kit | | | | Compiled system prompt for a specific AI persona | , | | | Lists "do/don't" expression examples for a brand kit | | | | Lists uploaded knowledge files for a brand kit | | | | Returns parsed text content of a knowledge file | | Write Tools All write tools require the scope.
Competitor writes additionally enforce a server side → workflow — call once with to preview, then re invoke with to write.
Brand kit content | Tool | Description | Key Parameters | | | | | | | Updates the brand kit's name, description, and high level metadata | , , , … | | | Saves mission, vision, story, promises | , core fields | | | Saves brand values, traits, principles, moods | , personality fields | | | Saves tone, verbal style, terminology, archetypes (and mirrors ) | , expression fields | | | Saves behavioral and writing constraints, compliance notes | , governance fields | | | Saves SEO keywords, tags, suggested keywords | , SEO fields | | | Updates brand colors, fonts, button styles, spacing, typography | , visual fields | | | Adds a "do" or "don't" example to the expression library | , , , | Audience & personas | Tool | Description | Key Parameters | | | | | | | AI generates a new audience persona from a brief (costs 1 token) | , | | | Updates fields on an existing audience persona | , , fields | | | AI generates a new AI assistant persona (costs 1 token) | , | | | Updates fields on an existing AI persona | , , fields | Products | Tool | Description | Key Parameters | | | | | | | Creates a product/service entry | , , , , , … | | | Updates fields on an existing product | , , fields | Competitors Both competitor write tools enforce the two step confirmation workflow.
At least one visual identity field (colors, fonts, tagline, value props, typography, button styles,