← All sections

01 · Brand Layer

For AI agents

Wire the brand into any AI tool — choose the live MCP path, or the no-MCP path: read URLs plus one file to upload.

01 — Connect an agent

Connect an agent

The brand is served over one live MCP endpoint — plus the read URLs and a one-file upload for tools that can't speak MCP. Pick your path with the switch below, wire it in once, paste the prompt, and the agent pulls real tokens, components, voice and layouts instead of inventing them. Once connected, start from the tested prompts on Prompts & examples.

How does your AI tool connect?

Tool can’t add MCP? .

MCP endpoint · live · Streamable HTTP
https://galton-ai-assets.vercel.app/api/mcp

Set up your tool

Pick your tool below. The endpoint above is the same everywhere — only the config key name changes, so each guide ships the exact snippet to paste.

Talk to the brand in a normal chat. Newer apps (Claude, ChatGPT, Perplexity, Mistral) add it as a custom connector; where that's not possible — e.g. the consumer Gemini app — switch this page to No MCP access for the load-a-file path.

  1. Open Settings → Connectors and choose Add custom connector.
  2. Name it GALTON Assets and set the Remote MCP server URL to the endpoint below.
  3. Leave Advanced settings (OAuth) empty — the server is public, no auth. Click Add.
  4. In any chat, open the "+" / Connectors menu and enable it, then paste the connect-and-remember prompt above.
url
https://galton-ai-assets.vercel.app/api/mcp

Note · Claude reaches the server from Anthropic's cloud, so a public URL (this one) is required — a localhost server won't work. Free plan = 1 custom connector.

  1. Settings → Apps & Connectors → Advanced settings → turn on Developer mode (Plus/Pro/Business/Enterprise).
  2. Back in Apps & Connectors, choose Create.
  3. Set the MCP Server URL to the endpoint below, Authentication = No authentication, and Save.
  4. Start a chat, attach the connector, and paste the connect-and-remember prompt above.
url
https://galton-ai-assets.vercel.app/api/mcp

Note · Developer mode (Plus/Pro/Business/Enterprise) gives the chat direct access to all the brand tools. No MCP? On any paid plan you can instead make a Custom GPT with the brand file as Knowledge — switch this page to No MCP access for the recipe. Business/Enterprise may require a workspace admin to enable dev mode first.

  1. Open Settings → Connectors → + Custom connector → Remote (Pro, Max or Enterprise).
  2. Set the MCP Server URL to the endpoint below, Authentication = None, Transport = Streamable HTTP, and save.
  3. Enable it in a thread, then paste the connect-and-remember prompt above.
url
https://galton-ai-assets.vercel.app/api/mcp

Note · Perplexity also browses the open web reliably, so as a quick alternative you can just paste the read URLs and it will fetch them.

  1. Open Connectors → Add connector → Custom MCP connector (available on all Le Chat plans).
  2. Set the Streamable-HTTP server URL to the endpoint below, no authentication, and save.
  3. Turn it on in a chat and paste the connect-and-remember prompt above.
url
https://galton-ai-assets.vercel.app/api/mcp

Paste the connect-and-remember prompt

Whichever path you picked, paste this once — into the chat, or into a Gem / Custom GPT’s instructions. It points at the brand, names the tools and the read URLs, and tells the agent to remember and follow the guidelines for the rest of the project.

Connect & remember

You now have access to the GALTON brand design system. Treat it as the single source of truth for anything GALTON-branded. PRIMARY SOURCE — live & queryable (preferred): the MCP server "galton-design" at https://galton-ai-assets.vercel.app/api/mcp. Start with get_skill — the versioned orchestrator skill (optionally save it; re-fetch when the brand version changes). Use the tools as authoritative: get_brand_overview, get_design_spec, list_tokens, get_component, get_voice_guide, get_linkedin_playbook, get_layout, get_fallback, get_chart_palette. IF YOU CANNOT USE MCP — the read URLs (open CORS, plain text/JSON): • https://galton-ai-assets.vercel.app/llms.txt — the curated index (start here) • https://galton-ai-assets.vercel.app/llms-full.txt — the whole brand in one file (best as uploaded Knowledge) • https://galton-ai-assets.vercel.app/brand.json — the structured index (tokens, components, pointers) • https://galton-ai-assets.vercel.app/design.md — the design system (colours, type, components) • https://galton-ai-assets.vercel.app/verbal-identity.md — verbal identity (brand voice + AI brief) • https://galton-ai-assets.vercel.app/linkedin.md — LinkedIn playbook REMEMBER THIS FOR THE REST OF THE PROJECT: before you produce ANY on-brand asset — UI, slide, post, image, or copy — pull the relevant tokens, components, voice and layouts from the source above and follow them exactly. Never invent a colour, font, radius or component. The accent is ALWAYS #FFD700 (colors.primary) — never red, blue or green. H1/display headlines and section titles (H2) are UPPERCASE. Anything undefined: derive via the fallback contract, or ask. The logo is white or black ONLY — never the primary yellow or any other color. White on dark, black on light or on a yellow surface. Never recolor, rotate, stretch, add shadows/gradients, or re-typeset the wordmark. Treat these guidelines as binding defaults for every future request in this project, without me having to repeat them.

Keep it on-brand across a project

For coding work, commit an AGENTS.md (read by Codex, Copilot, Cursor, Windsurf, Zed, Jules…) or CLAUDE.md at the repo root. The agent auto-loads it every session, so it keeps calling the MCP tools and following the brand without being reminded.

markdown
# AGENTS.md  (also works as CLAUDE.md)

## GALTON brand
This project follows the GALTON brand system. Before generating ANY
on-brand asset (UI, slides, posts, copy), pull the real values — don't guess.

- Source of truth: the "galton-design" MCP server at https://galton-ai-assets.vercel.app/api/mcp
  key tools (of 16): get_skill · get_brand_overview · list_tokens ·
  get_component · get_voice_guide · get_layout · get_fallback
- No MCP? the read URLs: https://galton-ai-assets.vercel.app/llms.txt (index), https://galton-ai-assets.vercel.app/llms-full.txt
  (the whole brand in one file) and https://galton-ai-assets.vercel.app/brand.json (structured index).

Rules: follow the tokens exactly; never invent colours, fonts, radii or
components; keep the logo white or black only; if something is undefined, read
get_fallback or ask. These are binding defaults for the whole project.

02 — What the agent pulls

What the agent pulls

What sits behind the endpoint — the source files and how they aggregate. Reference, not setup.

Not everything lives in design.md — that is only the design system. The full brand spans the files below, all aggregated into brand.json + llms.txt and exposed through the MCP tools. Point agents at the MCP server or /llms.txt, not at design.md alone.

  • design.mdDesign system — colours, type scale, components, the fallback contract, agent prompts
  • brand.mdBrand identity & long-form guide — about, logo policy
  • verbal-identity.mdVerbal identity — essence, personality, registers, lexicon, principles + a ready-to-paste AI brief
  • linkedin.mdLinkedIn playbook — post types, anatomy, hooks, hashtag rules
  • layouts.mdSlide canvas + layout archetypes & carousel recipes
  • assets.json · icons.jsonDownloadable logos, fonts and the icon library

Aggregated for agents · everything above is rolled into https://galton-ai-assets.vercel.app/brand.json (the structured index), https://galton-ai-assets.vercel.app/llms.txt (the curated index) and https://galton-ai-assets.vercel.app/llms-full.txt (the self-contained bundle), and queried live through 16 MCP tools — plus MCP resources and prompts on the same endpoint.

The orchestrator skill

skill.md (also the get_skill MCP tool) is the versioned orchestrator skill — it tells an agent which tool to use for which task and how to keep itself current. Saving it is optional — download it and drop it next to your AI tool (e.g. .claude/skills/…/SKILL.md), or let the agent fetch it itself.

skill.md
Preview skill.md
---
name: galton-brand
description: Routes any GALTON-branded output task (UI, pages, slides, posts, charts, copy, images) to the right knowledge via MCP tools or the read URLs. Use before creating any GALTON-branded asset.
compatibility: Requires network access to https://galton-ai-assets.vercel.app. MCP server at https://galton-ai-assets.vercel.app/api/mcp preferred; the read URLs work without MCP.
metadata:
  brand-version: "2.0"
  source: https://galton-ai-assets.vercel.app/skill.md
---

# GALTON Brand Layer — orchestrator skill

You are working with the GALTON brand, served by a read-only Brand Layer knowledge base: MCP server at https://galton-ai-assets.vercel.app/api/mcp (preferred) or the read URLs. It returns brand data only — YOU produce the asset in your own tools.

No brand tools visible? Connect first: `claude mcp add --transport http galton-brand https://galton-ai-assets.vercel.app/api/mcp` (or your client's HTTP-MCP equivalent). No MCP at all? Use the read URLs below.

## Keep this skill current

This skill is generated from the brand and carries its version (`2.0`). At the start of a session call `get_brand_overview` (it returns `version`; or read https://galton-ai-assets.vercel.app/brand.json meta) and compare versions — if they differ, re-fetch https://galton-ai-assets.vercel.app/skill.md and replace your saved copy. Saving the skill is optional: if your environment supports skills (e.g. `.claude/skills/galton-brand/SKILL.md`), save it there; otherwise just keep it in context.

## Hard rules (never break)

1. Never invent a colour, font, radius or component. The accent is ALWAYS #FFD700 (colors.primary) — never red, blue or green. H1/display headlines and section titles (H2) are UPPERCASE. Anything undefined: derive via the fallback contract, or ask.
2. For the complete rules of engagement call `get_agent_rules` once per session; `get_brand_overview` carries the critical rule and the voice rule.
3. Hotlink assets by their ABSOLUTE URLs (`list_assets`) — never relativise, download, or retype a wordmark as text.

## Route by task

| You are asked to make | Do this, in order |
|---|---|
| Anything (first step) | `get_brand_overview` — identity, surfaces, the critical rule. |
| Web / UI / HTML | Link the stylesheet `https://galton-ai-assets.vercel.app/brand.css` (fonts + token variables + `.bl-{component}` classes), take markup from `https://galton-ai-assets.vercel.app/snippets.json` or `get_component` (`snippetHtml`). Tokens: `list_tokens` (pass `ref` to resolve one). |
| Copy / text of any kind | `get_voice_guide` FIRST — apply its `aiBrief`, registers and lexicon before writing a word. |
| LinkedIn post | `get_voice_guide` → `get_linkedin_playbook` (post types, anatomy, hashtag rules) → for a carousel: `list_carousel_recipes` — pick the sequence by post type. |
| Slides / carousel visuals | `get_layout` — without id: the shared canvas + every archetype; with id: that layout's slot schema + example image → build the slide YOURSELF in your tool. |
| Icons | `list_icons` — pass `query` or `set` for hotlinkable icons: `url` (dark surfaces) or `lightUrl` (light surfaces). |
| Charts / data viz | `get_chart_palette` — categorical/sequential/semantic. Never a library-default rainbow. |
| Anything undefined | `get_fallback` — the derivation protocol. |
| Finding a rule | `search_design` (full-text) or `get_section`. |

## No MCP available?

Use the read URLs: https://galton-ai-assets.vercel.app/llms.txt (index) or https://galton-ai-assets.vercel.app/llms-full.txt (the whole brand in one file — good as uploaded Knowledge). Everything is open-CORS plain text/JSON.