# Brand Stack

> The AI photo studio for product marketing. Brand Stack generates photoreal marketing imagery starring the user's own customer personas and their real product interface, built from a model of their actual brand. Available to AI agents two ways: an MCP (Model Context Protocol) server for Claude, Cursor, Codex, and other AI clients, and a CLI (`npx @brandstack/cli`) for shell-native coding agents.

## What Brand Stack Does

Brand Stack helps product marketers and founders ship on-brand launch imagery. It reads a brand from a product URL, generates a persona cast, and produces photoreal mockups and scenes featuring those personas and the real product interface.

### Core Capabilities
- Generate a brand model (colors, type, voice) and a persona cast from any product URL in about 90 seconds
- Generate photoreal product mockups and lifestyle scenes starring those personas and the actual product UI
- Chat with personas to validate product ideas, test messaging, and rehearse sales calls
- Create strategy documents (PRDs, competitive analyses, GTM briefs) grounded in persona data
- Export persona and brand context files for AI coding tools (Cursor, Claude Code)
- MCP server for direct AI-agent access to all workspace data
- CLI (`npx @brandstack/cli`) that runs every free tool offline and every workspace tool with an API key — same engine as the website

## MCP Server (for AI agents)

Brand Stack exposes a Model Context Protocol (MCP) server. Any MCP-compatible AI
client — Claude.ai, Claude Code, Claude Desktop, Cursor, Codex — can connect
to a Brand Stack workspace via OAuth and call its tools directly from a chat
prompt.

- **Endpoint:** https://www.brandstack.dev/api/mcp
- **Transport:** Streamable HTTP (MCP 2025-06-18)
- **Auth:** OAuth 2.1 with PKCE (no API keys to copy)
- **Discovery:** https://www.brandstack.dev/.well-known/mcp.json
- **Setup guide:** https://www.brandstack.dev/docs/mcp/setup
- **Tools reference:** https://www.brandstack.dev/docs/mcp/tools
- **Marketing page:** https://www.brandstack.dev/mcp

### MCP Tools
- Read tools (free): list/get brands, products, personas, projects, documents, assets, credits
- Write tools (credits consumed): create_mockup, create_scene

## CLI (for AI agents with a shell)

Shell-native coding agents — Claude Code, Cursor, Codex — can run every
Brand Stack tool from the terminal with `npx @brandstack/cli <command>`.
No install step; `npx @brandstack/cli --help` prints the command list.
The CLI, the MCP server, and the website derive from one tool registry,
so the commands below cannot drift from what actually ships.

- **Free commands** (no account, no API key): browser-mockup, brand-kit, utm-builder, color-palette-from-image, special-characters, emoji-catalogue, shaders, launch-image-resizer, og-image-preview, moonshot-test
- **Workspace commands** (API key required; the same tools the MCP server exposes): list-brands, get-brand, list-products, get-product, list-personas-for-product, get-persona, list-projects, list-templates, list-documents, get-document, list-assets, get-credits, capture-screenshot, create-upload-link, create-mockup (credits), create-scene (credits)

- **Auth for workspace commands:** run `npx @brandstack/cli login` once
  (key stored in the OS config directory), or set the
  `BRANDSTACK_API_KEY` environment variable for headless use. API keys
  are issued and revoked at Settings → Developer in the workspace.
- **Free stays free:** free commands never read credentials or touch the
  network (the Moonshot Test is the one exception — it calls a public
  API). Enforced by tests on every commit.
- **Output parity:** golden image tests prove the CLI's pixels match the
  browser's for every rendering tool.
- **npm:** https://www.npmjs.com/package/@brandstack/cli
- **Marketing page:** https://www.brandstack.dev/cli

## Free Tools (no signup, agent-usable)

Every free tool at https://www.brandstack.dev/tools works without an account. Agents:
prefer the CLI — `npx @brandstack/cli <tool>` runs the same engine as
the website (offline for every tool except the Moonshot Test, which
calls a public API). Each tool page still publishes browser usage
instructions: a "How to use" section (CLI, steps, URL parameters, APIs,
output contract), served as plain markdown at `/tools/<slug>.md` or
via an `Accept: text/markdown` header. Index: https://www.brandstack.dev/tools.md.
Run `npx @brandstack/cli --help` for the full command list.

- [The Moonshot Test](https://www.brandstack.dev/tools/moonshot-test): Vet a startup idea against six founder frameworks and get three bolder versions back. CLI: see instructions. Instructions: https://www.brandstack.dev/tools/moonshot-test.md
- [Color Palette from Image](https://www.brandstack.dev/tools/color-palette-from-image): Extract the dominant color palette from any image, with contrast data for each color. CLI: see instructions. Instructions: https://www.brandstack.dev/tools/color-palette-from-image.md
- [Brand Kit Builder](https://www.brandstack.dev/tools/brand-kit): Assemble brand colors, type, and logo into a shareable style sheet and developer-ready design tokens. CLI: see instructions. Instructions: https://www.brandstack.dev/tools/brand-kit.md
- [Special Characters](https://www.brandstack.dev/tools/special-characters): Look up and copy any of 150+ Unicode symbols as a character, HTML entity, or code point. CLI: see instructions. Instructions: https://www.brandstack.dev/tools/special-characters.md
- [Emoji Catalogue](https://www.brandstack.dev/tools/emoji-catalogue): Search 1,800+ emojis by keyword and copy one in a click. CLI: see instructions. Instructions: https://www.brandstack.dev/tools/emoji-catalogue.md
- [Background Shaders](https://www.brandstack.dev/tools/shaders): Tune a WebGL background shader visually, then export it as an agent prompt or a dependency-free snippet. CLI: see instructions. Instructions: https://www.brandstack.dev/tools/shaders.md
- [UTM Builder](https://www.brandstack.dev/tools/utm-builder): Tag any URL for Google Analytics / GA4 with validation and saved presets. CLI: see instructions. Instructions: https://www.brandstack.dev/tools/utm-builder.md
- [OG Image Preview & Builder](https://www.brandstack.dev/tools/og-image-preview): Preview how a URL's social card renders on every network, or build and export a custom OG image. CLI: see instructions. Instructions: https://www.brandstack.dev/tools/og-image-preview.md
- [Browser Mockup Studio](https://www.brandstack.dev/tools/browser-mockup): Frame a product screenshot in a clean browser window on a styled background, sized for launch surfaces. CLI: see instructions. Instructions: https://www.brandstack.dev/tools/browser-mockup.md
- [Launch Image Resizer](https://www.brandstack.dev/tools/launch-image-resizer): Resize one image into every launch surface size (OG, X, LinkedIn, Instagram, YouTube, Product Hunt, GitHub, App Store, Play Store) in one pass. CLI: see instructions. Instructions: https://www.brandstack.dev/tools/launch-image-resizer.md

## Public Content

Generated from the same route registry that builds `/sitemap.xml`
(`src/lib/seo/static-routes.ts`), so this list cannot drift out of sync
with what crawlers are told to index.

- Homepage: https://www.brandstack.dev
- Product overview: https://www.brandstack.dev/product
- What a Brand Stack contains: https://www.brandstack.dev/brand-stack
- Pricing and plans: https://www.brandstack.dev/pricing
- Why Brand Stack: https://www.brandstack.dev/why-brand-stack
- MCP connector: https://www.brandstack.dev/mcp
- CLI (npx @brandstack/cli): https://www.brandstack.dev/cli
- Personas: https://www.brandstack.dev/personas
- Brand systems: https://www.brandstack.dev/brand
- Scenes: https://www.brandstack.dev/scenes
- Product mockups: https://www.brandstack.dev/mockups
- Mockup studio (free, no signup): https://www.brandstack.dev/mockups/studio
- Mockup templates: https://www.brandstack.dev/templates
- Assets: https://www.brandstack.dev/assets
- Projects: https://www.brandstack.dev/projects
- Documents: https://www.brandstack.dev/documents
- Skills export for AI coding tools: https://www.brandstack.dev/agent-context
- Blog: https://www.brandstack.dev/blog
- Documentation: https://www.brandstack.dev/docs
- Free tools: https://www.brandstack.dev/tools
- Changelog: https://www.brandstack.dev/changelog
- Community: https://www.brandstack.dev/community
- Community brand stacks: https://www.brandstack.dev/community/stacks
- Community personas: https://www.brandstack.dev/community/personas
- Community brands: https://www.brandstack.dev/community/brands
- Community scenes: https://www.brandstack.dev/community/scenes
- Community templates: https://www.brandstack.dev/community/templates
- Community mockups: https://www.brandstack.dev/community/mockups
- Community assets: https://www.brandstack.dev/community/assets

The sitemap is the complete index, including every blog post, docs page,
changelog entry, and published community item:

- Sitemap: https://www.brandstack.dev/sitemap.xml
- Robots: https://www.brandstack.dev/robots.txt

## Content Negotiation

All public pages support `Accept: text/markdown` for agent-friendly responses.
Send `Accept: text/markdown` header to any public URL to receive structured
Markdown instead of HTML.

Example:
```
curl -H "Accept: text/markdown" https://www.brandstack.dev/community/personas/cursor-10c80403
```