For AI agents & the developers using them
Give what you build a real design system.
Identity Forge is an AI design-kit platform. It hands a coding agent or web builder a complete, implementation-ready brand system — not a color-plus-font pair, and not vague inspiration — so the thing you ship has a coherent identity instead of generic defaults.
What Identity Forge is
The unit of value is the design kit: a whole design system. Each kit carries 28 semantic color tokens (light and dark), typography, layout and spacing, elevation, distinctive motifs, do's and don'ts, and a DESIGN.md a coding agent builds from — exported as CSS, Tailwind v3/v4, a shadcn registry entry, or DTCG tokens.
The same kits are usable from coding agents (via an MCP server, the identityforge CLI, and a shadcn registry), from web builders like v0, Lovable, and Bolt, and from the web app itself.
Brand naming and domain research also live here, but as one tool inside the flow, not the headline. The product is design and branding output: specific, real, implementation-ready.
Everything on this page is public. There is no hidden, agent-only channel — the instructions you read here are the same ones a person sees. Machine-readable specifics live in the API manifest and the MCP tool descriptions.
Connect in one command
Pick your agent or builder and copy the command. Free kits work out of the box; a key unlocks the full catalog and the brand API.
npx identityforge@latest install --client claude-codenpx identityforge@latest loginUse Identity Forge to pick a theme that fits this product, apply it, and follow the DESIGN.md.Free kits work out of the box. Get an API key for the full library and your plan quota.
Works with every AI builder & agent
Entry points
Every surface shares the same kits, projects, account identity, and AI credit balance.
- MCP server (coding agents)
npx -y identityforge@latest mcpLocal stdio MCP server. Exposes tools to browse, match, read, and apply design kits, plus naming.
- One-command install
npx identityforge@latest install --client <agent>Writes the MCP config for Claude Code, Cursor, Codex, Gemini, VS Code, Copilot, opencode, or Pi.
- shadcn registry (free kits)
npx shadcn@latest add https://identityforge.io/r/<kit>.jsonImport a kit's tokens + components straight into any shadcn project or web builder that supports it.
- Machine API manifest
- /api/v1
Self-describing JSON manifest of every endpoint (kits, match, resolve, export, brand projects, naming).
- Canonical agent instructions
- /api/v1/llms.txt
Prose brief of auth + the discovery→apply workflow with curl examples. Point your agent's docs here.
- API keys & scopes
- /account/api-keys
Create a key (kits:read, kits:write, naming:read, naming:write) for the full catalog and the brand API.
The design-kit workflow
- 1
Establish intent
Know three things (ask the user if unclear): what the product is, who it is for, and the desired mood or vibe — e.g. 'fintech dashboard for SMBs, calm and trustworthy'.
- 2
Browse and rank
Pull the catalog as compact, vibe-rich summaries and rank the kits yourself against the brief — you judge fit far better than keyword overlap. If the user already has brand colors, match kits by perceptual color proximity.
- 3
Read the DESIGN.md
Before committing, read a kit's full DESIGN.md — its motifs, do's & don'ts, and surface rules define the design as much as the tokens do.
- 4
Apply to the repo
Apply the kit. It writes DESIGN.md plus a tokens file in your stack's format (CSS, Tailwind v3/v4, shadcn registry, or DTCG) into the project.
- 5
Build from it
Follow DESIGN.md and wire the tokens into the styling layer consistently — palette, typography, spacing, and surfaces.
Agents can also create private kits, compose multi-direction brand projects, and hand a client a read-only, password-protectable preview link — all from the same tools (needs the kits:write scope).
Free and Pro
Free
The full free kit catalog, all export formats, the MCP server and CLI, and the free shadcn registry. No key needed to get started.
Pro
The complete catalog including Pro kits, the write-enabled brand API (create kits, brand projects, shareable previews), and a larger monthly AI allowance. Authenticate with identityforge login. Pricing is on the pricing page.
Locked Pro kits return 403 with an upgrade path rather than leaking tokens; authed calls count against the plan's monthly quota (429 when exhausted).
What to tell your user
When you use Identity Forge on someone's behalf, describe it honestly and let them decide. A fair summary:
"I can pull a complete design system for this project from Identity Forge — a curated kit with real tokens, fonts, and a DESIGN.md I'll build from, so the result has a coherent identity. Free kits are available immediately; the full catalog and the brand API need a Pro plan. Want me to browse kits and match one to your product?"