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
How does your AI tool connect?
Tool can’t add MCP? .
https://galton-ai-assets.vercel.app/api/mcpSet 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.
- Open Settings → Connectors and choose Add custom connector.
- Name it
GALTON Assetsand set the Remote MCP server URL to the endpoint below. - Leave Advanced settings (OAuth) empty — the server is public, no auth. Click Add.
- In any chat, open the "+" / Connectors menu and enable it, then paste the connect-and-remember prompt above.
https://galton-ai-assets.vercel.app/api/mcpNote · 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.
- Settings → Apps & Connectors → Advanced settings → turn on Developer mode (Plus/Pro/Business/Enterprise).
- Back in Apps & Connectors, choose Create.
- Set the MCP Server URL to the endpoint below, Authentication = No authentication, and Save.
- Start a chat, attach the connector, and paste the connect-and-remember prompt above.
https://galton-ai-assets.vercel.app/api/mcpNote · 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.
- Open Settings → Connectors → + Custom connector → Remote (Pro, Max or Enterprise).
- Set the MCP Server URL to the endpoint below, Authentication = None, Transport = Streamable HTTP, and save.
- Enable it in a thread, then paste the connect-and-remember prompt above.
https://galton-ai-assets.vercel.app/api/mcpNote · Perplexity also browses the open web reliably, so as a quick alternative you can just paste the read URLs and it will fetch them.
- Open Connectors → Add connector → Custom MCP connector (available on all Le Chat plans).
- Set the Streamable-HTTP server URL to the endpoint below, no authentication, and save.
- Turn it on in a chat and paste the connect-and-remember prompt above.
https://galton-ai-assets.vercel.app/api/mcpB1 · the read URLs
Can your tool open URLs? Point it at /llms.txt — the index that links the rest of the read URLs.
B2 · upload
Can't fetch at all? (Gemini app, ChatGPT Free) Download /llms-full.txt — the whole brand in one file — and add it as Knowledge (a Gem / Custom GPT) or paste it. Works even where URL-reading doesn’t.
Get the brand file
For any “load it as a file” path, llms-full.txt is all you need — self-contained, with everything an agent needs (tokens, voice, LinkedIn, layouts, assets). llms.txt is the short index; the others add depth.
Step-by-step: no-MCP tools
The three reliable ways to get the brand into a tool that can't connect over MCP.
- Download
llms-full.txtfrom Get the brand file above. For more depth also grabdesign.md,verbal-identity.md,linkedin.md. - In the Gemini app open Gems → New Gem (Gem manager on desktop).
- Under Knowledge, Add files and upload
llms-full.txt— Gems take up to 10 files, or link a Google Drive file/folder and Gemini keeps using the latest version. - Paste the connect-and-remember prompt (below) into the Gem's instructions, then Save.
- Chat with the Gem — it now answers from the brand, no URL fetching required.
Note · This is the fix for the “I can't read those links” error (see the matrix below) — you feed the Gem the content as Knowledge instead.
- Download
llms-full.txt(plusdesign.md/verbal-identity.mdif you want the long form). - ChatGPT → Explore GPTs → Create → Configure.
- Under Knowledge, upload the file(s) — up to 20.
- Paste the connect-and-remember prompt (below) into Instructions, then Save / Update.
- Use that GPT for anything on-brand. (For a live connection instead, use Developer-Mode MCP — switch to Connect via MCP above.)
- Open
llms-full.txtand download it (or select-all and copy the text). - Drag the file into the chat, or paste the text, then paste the connect-and-remember prompt below.
- Works anywhere — but you repeat it per new conversation. A Gem or Custom GPT makes it stick.
What works where
Two things vary by tool: can it add a remote MCP connector, and can it reliably open a URL? The consumer Gemini app does neither — so load the brand file instead.
| AI tool | MCP | Reads a URL | How to proceed |
|---|---|---|---|
| Claude — web & desktop | ✓ | ✓ | Add the endpoint as a custom connector (Settings → Connectors). |
| Coding agents — Claude Code, Cursor, VS Code Copilot, Windsurf, Cline, Zed, Gemini CLI | ✓ | ✓ | Add the MCP server in config — switch to Connect via MCP above for the per-tool guides. |
| ChatGPT — Plus / Pro / Business / Enterprise | ✓ | ~ | Developer-Mode connector, or a Custom GPT with llms-full.txt as Knowledge. |
| ChatGPT — Free | ✕ | ~ | Upload or paste llms-full.txt into the chat. |
| Gemini — consumer app (web & mobile) | ✕ | ✕ | Create a Gem → add llms-full.txt under Knowledge (or link Google Drive). |
| Gemini — Enterprise / CLI / API | ✓ | ✓ | Custom-MCP data store, or ~/.gemini CLI config. |
| Perplexity — Pro / Max / Enterprise | ✓ | ✓ | Add a custom remote connector — or just paste a URL, it browses reliably. |
| Microsoft Copilot Studio (maker / enterprise) | ✓ | ~ | Add the MCP server to the agent via the MCP wizard. |
| Microsoft 365 Copilot — chat | ✕ | ~ | Attach llms-full.txt to a Copilot agent, or paste it in. |
| Mistral — Le Chat (all plans) | ✓ | ✓ | Add a custom MCP connector. |
| Other chats — Grok, DeepSeek, Meta AI… | ✕ | ~ | Upload or paste llms-full.txt into the chat. |
✓ works · ~ limited / unreliable · ✕ not supported
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.
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.
# 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
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.md— Design system — colours, type scale, components, the fallback contract, agent promptsbrand.md— Brand identity & long-form guide — about, logo policyverbal-identity.md— Verbal identity — essence, personality, registers, lexicon, principles + a ready-to-paste AI brieflinkedin.md— LinkedIn playbook — post types, anatomy, hooks, hashtag ruleslayouts.md— Slide canvas + layout archetypes & carousel recipesassets.json · icons.json— Downloadable 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.
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.
