MCP Tools Reference

Brand Kit OS exposes 12 tools through its MCP server. Each tool retrieves specific brand data for use in AI conversations.

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
API Key: For Cursor, Claude Code, and other MCP clients — pass your key in the Authorization: Bearer header

Available Tools

Tool	Description	Parameters
`list_brand_kits`	Lists all brand kits the user has access to	None
`get_brand_kit`	Returns all sections of a brand kit in a single call — core, personality, expression, audience, governance, products, personas, competitors, visuals, and SEO	`brand_kit_id`
`get_brand_kit_summary`	Returns a compact overview of a brand kit (~500 tokens) — ideal for quick context loading	`brand_kit_id`
`get_brand_kit_core`	Returns core brand info: mission, vision, story, promises	`brand_kit_id`
`get_brand_kit_personality`	Returns brand values, principles, traits, and moods	`brand_kit_id`
`get_brand_kit_expression`	Returns tone of voice, verbal style, terminology, and voice archetypes	`brand_kit_id`
`get_brand_kit_audience`	Returns target audience personas with demographics, motivations, and pain points	`brand_kit_id`
`get_brand_kit_governance`	Returns behavioral constraints, writing rules, and compliance notes	`brand_kit_id`
`get_brand_kit_products`	Returns products/services with descriptions, pricing, and USPs	`brand_kit_id`
`get_brand_kit_personas`	Returns AI personas with roles, rules, and tone overrides	`brand_kit_id`
`get_brand_kit_competitors`	Returns competitor analysis data	`brand_kit_id`
`get_brand_kit_visual_identity`	Returns colors, fonts, logos, and visual style details	`brand_kit_id`
`get_brand_kit_seo`	Returns SEO keywords, tags, and suggested keywords	`brand_kit_id`

How Tools Are Used

When connected via Remote Connector, Cowork Plugin, or API key, your AI tool can call these tools to pull live brand data into conversations.

Example Flow

Claude calls list_brand_kits to see available kits
User selects a brand kit
Claude calls get_brand_kit_summary for a quick overview
Claude calls specific tools (e.g., get_brand_kit_expression) for detailed data as needed

Full Context in One Call

Use get_brand_kit to retrieve all sections at once. This is useful when you need comprehensive brand context without making multiple tool calls.

Response Format

All tools return structured JSON containing the requested brand data. The get_brand_kit_summary tool returns a condensed version optimized for token efficiency (~500 tokens vs. thousands for individual calls).

Connection Methods

These tools are available through all three connection methods:

Remote Connector — OAuth, no API key (setup guide)
Cowork Plugin — Claude Desktop plugin with skills (setup guide)
API Key — Cursor, Claude Code, other tools (setup guide)

Catalog parity with the Cowork plugin

The 12 tools listed here match the catalog shipped in the Cowork plugin README (v1.2). If you build your own client, expect the same names and signatures: list_brand_kits, get_brand_kit_summary, get_brand_kit, get_brand_kit_core, get_brand_kit_personality, get_brand_kit_expression, get_brand_kit_products, get_brand_kit_audience, get_brand_kit_governance, get_brand_kit_personas, list_knowledge_files, get_knowledge_file.