Using Connectors

Connect Brandparser to Claude, ChatGPT, Le Chat, Cursor, Windsurf, and other MCP-compatible AI tools for live brand context while you work.

The Brandparser MCP (Model Context Protocol) server gives AI tools direct access to your brand guidelines. Instead of pasting URLs into chats, your AI reads your brand data automatically — colors, fonts, voice, logos, and more — as part of every conversation.

Prerequisites

A paid plan (Export or API) with at least one completed brand analysis
Claude, ChatGPT, Le Chat: No additional setup — connect via OAuth (see below)
Cursor, Windsurf, or other MCP tools: An MCP key from Integrations > Connectors

Setup

Claude (recommended)

Claude connects via OAuth — no API key or config files needed.

Open Claude → Customize → Connectors
Click the "+" button to add a connector
Paste the MCP Server URL: https://api.brandparser.com/mcp
Sign in with your Brandparser account when prompted
Done — Claude now has access to your brand guidelines

If you belong to multiple workspaces, you'll be asked to select one during sign-in.

ChatGPT

ChatGPT connects via OAuth — no API key or config files needed. ChatGPT Apps require a Plus, Team, or Enterprise plan.

Open ChatGPT → Settings → Apps → Advanced settings → turn on Developer mode
Still in Settings → Apps, click Create app (top-right)
Enter a name (e.g. brandparser), paste the MCP Server URL: https://api.brandparser.com/mcp, and set Authentication to OAuth
Check "I understand and want to continue", then click Create
Sign in with your Brandparser account when prompted
Done — ChatGPT now has access to your brand guidelines

If you belong to multiple workspaces, you'll be asked to select one during sign-in.

Le Chat (Mistral)

Le Chat connects via OAuth — no API key or config files needed.

Open Le Chat → Intelligence → Connectors
Click "+ Add Connector" → Custom MCP Connector
Enter a name (e.g. brandparser) and paste the MCP Server URL: https://api.brandparser.com/mcp
Click Connect and sign in with your Brandparser account when prompted
Done — enable Brandparser as a tool in your conversation via the Tools button

If you belong to multiple workspaces, you'll be asked to select one during sign-in.

Cursor

Add to Settings > MCP Servers:

{
  "mcpServers": {
    "brandparser": {
      "url": "https://api.brandparser.com/mcp",
      "headers": {
        "Authorization": "Bearer bp_mcp_your_key_here"
      }
    }
  }
}

Windsurf

Add to your MCP configuration:

{
  "mcpServers": {
    "brandparser": {
      "serverUrl": "https://api.brandparser.com/mcp",
      "headers": {
        "Authorization": "Bearer bp_mcp_your_key_here"
      }
    }
  }
}

Note: Windsurf uses serverUrl instead of url.

Available tools

Once connected, your AI tool has access to these tools:

Tool	Description
`list_brands`	List all brands in your workspace. Supports an optional `query` parameter to filter by name.
`get_brand_colors`	Hex color values mapped to UI roles (background, text, headings, links, buttons), full palette, and WCAG contrast data.
`get_brand_fonts`	Google Fonts loading URLs and CSS `font-family` declarations for body and headings.
`get_brand_logos`	Ready-to-use `<img>` tags for the brand logo on light and dark backgrounds. When logos are inline SVGs, returns the SVG markup directly.
`get_brand_voice`	Voice persona, writing rules, voice traits with do/don't examples, approved and forbidden phrases, and a ready-to-use LLM system prompt.
`get_brand_identity`	Brand description, mission, vision, core values, positioning messages, and target audiences.
`get_brand_images`	Photography, illustrations, icons, and product screenshots organized by category, plus image generation prompts.
`get_brand_web`	Frontend toolkit preferences — component libraries, CSS framework, icon sets, meta-framework, runtime, accessibility target, animation, and preferred coding patterns.
`get_brand_audio`	Voice AI providers and voice IDs, music generation preferences, audio asset URLs, and sound design notes.

All brand tools accept a brand parameter — the brand name or ID. The server resolves names using exact, case-insensitive, and partial matching. If the name is ambiguous, call list_brands first.

Built-in prompts

The server also provides two prompt templates that pre-fill your conversation with the right brand context:

write-with-brand-voice — For writing tasks (copy, emails, posts, docs). Takes a brand and topic parameter. Injects voice guidelines, writing rules, and a verification checklist.

create-with-brand-style — For design tasks (HTML, CSS, UI mockups). Takes a brand and description parameter. Injects colors, typography, and art direction guidelines.

Recommended workflows

The server tells your AI to call only the tools it needs based on the task. Start with list_brands if you do not already know the brand name or ID.

Writing (copy, emails, social posts, naming, docs):

get_brand_voice + get_brand_identity

Design (HTML, CSS, UI, mockups, code):

get_brand_colors + get_brand_fonts + get_brand_logos + get_brand_web

Image generation:

get_brand_images

Audio (podcasts, video soundtracks, voice-overs, jingles):

get_brand_audio

Full creative (writing + design):

get_brand_voice + get_brand_identity + get_brand_colors + get_brand_fonts + get_brand_logos + get_brand_web

How it works

The MCP server is stateless — each request creates a fresh server instance scoped to your workspace. All brands in the workspace are accessible through the same connection.

When an AI tool connects, it receives your brand guidelines as context. The AI can reference your colors, voice, typography, and more during the conversation.

Claude, ChatGPT, and Le Chat authenticate via OAuth — your Brandparser login grants access to your workspace. Cursor, Windsurf, and other tools use an MCP API key that is scoped to your workspace.

Troubleshooting

"Brand guidelines require a paid plan" — Your workspace needs an active Export or API plan. Upgrade at Settings > Billing.

"Brand not found" — The brand name did not match any brands in your workspace. Call list_brands to see available brands, or use the brand ID directly.

"Brand analysis is [status]" — The brand analysis has not completed yet (status may be queued, processing, or another non-complete state). Wait for it to finish in the dashboard before using MCP tools. If the status is failed, try re-running the analysis from the dashboard.

Connection fails (Cursor/Windsurf) — Verify your MCP key has not been revoked. MCP keys start with bp_mcp_ (production API keys starting with bp_prod_ also work). Create a new key at Integrations > Connectors if needed.

OAuth login fails (Claude, ChatGPT, or Le Chat) — Ensure your Brandparser account has an active paid plan. If you belong to multiple workspaces, select the correct one during authentication.

Wrong workspace (Claude) — Disconnect the connector in Claude Customize → Connectors, then reconnect and select a different workspace during sign-in.

Developer Mode not available (ChatGPT) — ChatGPT Apps require a Plus, Team, or Enterprise plan. Free plan users should use AI Links instead.

Wrong workspace (ChatGPT) — Delete the app in ChatGPT Settings → Apps, then recreate it and select a different workspace during sign-in.

Wrong workspace (Le Chat) — Remove the connector in Le Chat Intelligence → Connectors, then re-add it and select a different workspace during sign-in.

Tools not appearing (Le Chat) — After connecting, you must enable Brandparser as a tool for each conversation. Click the Tools button (four squares icon) below the chat input to enable it.

Using Connectors

On this page