Developers · Preview
Brand API for AI tools Call the brand before you generate.
The Brand Source API and MCP server are a brand API for AI tools: they give developers and generators the right logo, design tokens, tone and rules, pinned to a version.
Connect in one line.
01MCP
# Claude Code. Illustrative: endpoint and auth flow to confirm at release.
claude mcp add --transport http brand-source https://api.source.brand1.ai/mcp
OAuth 2.1 sign-in on first use. Your organisation's admin grants scopes.
02REST
curl -G https://api.source.brand1.ai/v1/brands/specimen-halden/summary \
--data-urlencode "task=Instagram carousel" \
--data-urlencode "channel=social" \
-H "Authorization: Bearer $SOURCE_KEY"
Responses are pinned to a version and returned as data, never as instructions.
03What comes back
{
"brand": "specimen-halden",
"version": "2.4.0",
"voice": { "traits": ["warm", "exact", "unhurried"] },
"logo": { "asset": "halden-lockup-indigo.svg", "clearspace": "1x" },
"mandatories": ["AI label on generated images"]
}
Recorded example from the specimen brand, shortened for reading.
MCP tools
An MCP server for brand: six tools, one brand.
Each tool reads from the same Brand Source your people use, so on-brand AI generation starts from the approved brand, not a guess.
| Tool | Returns | Scope |
|---|---|---|
get_brand_summary | Core summary, attributes, key voice rules, logo and token references, mandatories | source:read |
get_voice_rules | Tone, vocabulary and examples for a channel and language | source:read |
get_tokens | Compiled tokens for one platform and mode | source:read |
get_rules | Do and don't, mandatories and AI-label rules for a channel and market | source:read |
search_assets | Approved assets, with signed links valid for 15 minutes | assets:read |
check_usage | A Brand Check score, sub-scores, hard fails and fixes | check:run |
Governed
Safe to call.
Design tokens API formats
DTCG · CSS · Tailwind · iOS · Android · Figma
- 01Read-only by defaultChanges arrive as proposals for a person to approve, never as edits.
- 02Pinned to a versionEvery call names the version it used, so work can be traced and repeated.
- 03Scoped keysSeparate keys per client and per vendor, each with only the access it needs.
- 04Every call recordedAn audit log the brand owner can read at any time.
Where the brand guidelines API fits.
The API reads from Brand Source, the digital brand guidelines platform, and output can be scored by Brand Check. Every file Brand1 delivers follows our AI and Content Credentials policy. Brand1, a brand and creative studio, builds the brand first; the API makes it callable.
Brand API, answered
How do you make AI tools generate on-brand content?
Make AI tools generate on-brand content by giving them the brand as data before they generate. The Brand Source API and MCP server return the right logo, design tokens, tone of voice, required lines and format rules, pinned to a version. Brand Check then scores the output, and a person signs off anything that matters.
What is an MCP server for brand guidelines?
An MCP server for brand guidelines lets AI assistants that support the Model Context Protocol read a brand directly. The Brand Source MCP server offers six read-only tools that return brand summaries, assets, tokens and rules. Changes arrive only as proposals for a person to approve, and every call is recorded in an audit log.
Is the Brand Source API available?
The Brand Source API and MCP server are in preview. Access comes with a Brand Source licence, and pilots start in March 2027. Endpoint names and the sign-in flow may change before release. Developers building with a client brand can request early access; cost is scope-dependent and covered on the price sheet.
Which design token formats does Brand Source export?
Brand Source exports design tokens in DTCG, the W3C Design Tokens Community Group format, and in CSS, Tailwind, iOS, Android and Figma formats. Tokens cover colour, type and spacing, and every export names the brand version it came from, so code, design files and AI tools stay in step with the brand.