BrandSweets

Your brand, sweetened for agents.

brand infrastructure / developer toolsverifiedbrandsweets.com

BrandSweets is the brand home for the agent era, and its own first customer — the site you are reading is rebuilt from this document. A brand used to live in a PDF no machine could read. Now agents design, extract, and ship on a brand's behalf, and they need something better: a structured, versioned source of truth they can read to stay on-brand and write to when a human asks. So we built the living brand book. Every brand becomes a brand doc that serializes losslessly to brand.md, tokens.json, brand.css, and a per-brand MCP endpoint. Agents propose; a person approves. Nothing leaves without clearing a taste floor. And because it is plain files, you can walk out the door with your brand any time you like.

Color

primarydark

Caramel

#a4501c

The single brand accent. CTAs, links, the mark, and caramel emphasis on paper. Used sparingly against paper and ink.

surfacedark

Sugar Paper

#fbf7ef

The page. Warm off-white paper — the ground the whole specimen sits on. Never plain #ffffff.

surfaceMuteddark

Marzipan

#f1e8d8

Panels, cards, and inset blocks that need to sit just off the paper ground.

textdark

Cocoa Ink

#241c14

Headlines and body text on paper — a warm near-black, not pure black.

textMuteddark

Toffee Grey

#6b5d4c

Captions, eyebrows, metadata, and secondary text. Still AA on paper.

borderdark

Wafer

#e7dcc9

Hairline rules, dividers, and card borders. Decorative — never load-bearing for contrast.

successdark

Pistachio

#2f7d51

Positive product states — a clean extraction, a saved brief. UI only, never decorative.

dangerdark

Redcurrant

#b23a2b

Errors and destructive actions — a failed extraction, a validation block. UI only.

Typography

display → Frauncesheading → Hanken Groteskbody → Hanken Groteskmono → Space Monoquote → Fraunces

Frauncesfraunces

google

Your brand, sweetened for agents.

Foundry:: Undercase Type
Weights:: 400, 400, 500, 600, 900

SIL Open Font License via Google Fonts — free to serve. Loaded, never re-sold or claimed as bespoke.

Hanken Groteskhanken-grotesk

google

Your brand, sweetened for agents.

Foundry:: Hanken Design Co.
Weights:: 400, 500, 600, 700

SIL Open Font License via Google Fonts — free to serve.

Space Monospace-mono

google

Your brand, sweetened for agents.

Foundry:: Colophon Foundry
Weights:: 400, 700

SIL Open Font License via Google Fonts — free to serve.

Gradients

caramel-washHero and section washes over paper — a warm caramel glow behind content. Atmosphere only, never an object.

Voice & Tone

confidentprecisewarmanti-hype

Do

+Lead with the verb — say what the reader can do, not how they will feel
+Name the surface plainly: brand.md, tokens.json, brand.css, the MCP endpoint
+Keep the taste floor visible — every claim about quality should be checkable
+Write like a specimen caption: precise, set, and quietly assured
+Let hierarchy and whitespace carry emphasis; reach for a bigger idea before a bigger adjective
+Say 'humans approve' out loud — the human-in-the-loop is the point, not a footnote

Don't

−Never 'unlock', 'supercharge', 'seamless', 'effortless', or 'revolutionary'
−No exclamation points — the confidence lives in the claim, not the punctuation
−Don't call agents 'magic'; they read a document, so say so
−No 'AI-powered' as a feature — the brand doc is the feature
−Avoid 'unleash', 'empower', 'game-changing', 'next-gen', 'leverage', 'synergy'
−Don't promise 'one-click' anything; describe the actual step

Sample copy

auth — accounts-launch-soon noticenotification

Accounts launch soon. For now your draft stays private to this session; claiming and saving arrive with sign-in.

auth — claim-your-brand explainerbody

Claiming a brand ties it to your account and unlocks verification, versioning, and the MCP endpoint. Sign-in is a moment away.

closing call-to-action bandheadline

Ready to sweeten a brand?

create-intake holding state after a brief is capturedempty-state

Brief captured. The agent-guided generation step is on the way; until then, nothing is faked — here is exactly what happens next with what you gave us.

primary button — begin creation intakecta

Create a brand

primary button — begin extractioncta

Extract my brand

secondary button — open a brand's pagecta

Open the brand book

empty state — no brands yet in a listempty-state

No brands here yet. Extract one from a domain, or start a new one from a brief.

404 / error page bodyerror

This page isn't in the book. The link may be old, or the brand may be private. Head back to the shelf.

extraction failed errorerror

We couldn't reach that domain. Check the spelling and that the site is live, then try again.

extraction in-progress statusnotification

Reading your site in a real browser — colors, type, logo, voice. This usually takes ten to thirty seconds.

extraction complete confirmationnotification

Draft ready. We pulled your palette, type, and logo into a brand doc — review it, then claim it.

site footer linemicrocopy

BrandSweets — the living brand book. Made to be read by people and agents alike.

onboarding fork card — 'I have a brand'body

Type your domain. We run a real browser over it and read the colors, type, logo, and voice into a draft you can review.

onboarding fork card — 'I need a brand'body

Start from a brief — a name, a one-liner, an audience, a few vibe words. We shape it into a complete brand doc you can claim.

hero eyebrow / kicker above the headlinemicrocopy

The living brand book, for the agent era

landing hero headlineheadline

Your brand, sweetened for agents.

landing hero subline beneath the headlinebody

Turn a brand into a structured system agents can read to stay on-brand everywhere, and write to while a human approves. Extract an existing brand from its domain, or start a new one from a brief.

three-surface explainer — tokens.json / brand.css (apply)body

tokens.json and brand.css carry role-based color, type, and spacing. One import and a prototype is on-brand by construction.

three-surface explainer — MCP endpoint (connect)body

The MCP endpoint gives an agent the right logo, the right tokens, the right copy — and a way to propose changes a human approves.

three-surface explainer — brand.md (read)body

brand.md is the narrative brief an agent grounds on before it writes a word — voice, story, dos and don'ts, in one readable file.

section heading — the three machine surfacesheadline

One document, three surfaces.

Usage Rules

SHOULDShip the warm dark counterpartaccessibility
Every surface has a full dark counterpart on the deep-toffee ground — warm, not blue-black. The light/dark pair is a demo of the schema's dark dimension, so keep both honest.
MUSTSay humans approve out loudvoice
Wherever copy describes an agent writing to a brand, name the approval step. Agents propose; a person signs off. Never imply autonomous changes ship unreviewed.
MUSTHonor the one-cap-height clearspacelogo
The primary lockup needs one cap-height of clear paper on every side. Nothing — rule, image, or type — enters that margin.
MUST NOTCaramel is the one sweet notecolor
Caramel is an accent on paper and ink, not a field. Never flood a page or a full section with it; the warmth reads as premium precisely because it is rationed. One sweet note, not a bag of candy.
MUSTGrounds are warm paper, never sterile whitecolor
Every light surface sits on Sugar Paper (#fbf7ef) or Marzipan, never pure #ffffff. The warmth of the ground is half the brand; plain white breaks it.
SHOULDFraunces sets statements, not paragraphstypography
Fraunces carries the hero line, cover, and pull quotes. Running body and UI copy are set in Hanken Grotesk; never set a paragraph in the display serif.
MUST NOTCut the hype lexiconvoice
No 'unlock', 'supercharge', 'seamless', 'effortless', 'revolutionary', 'AI-powered', or exclamation points. State the capability plainly; the confidence lives in the claim.

mcpConnect your agent to BrandSweets

live endpoint

Point any MCP client at this brand and every session grounds itself in the real system — colors, type, voice, usage rules. Read-only.

endpointhttps://mcp.brandsweets.com/brandsweets/mcp

.mcp.json

{
  "mcpServers": {
    "brandsweets-brandsweets": {
      "type": "http",
      "url": "https://mcp.brandsweets.com/brandsweets/mcp"
    }
  }
}

claude codeclaude mcp add --transport http brandsweets-brandsweets https://mcp.brandsweets.com/brandsweets/mcp