Brandize MCP Server

Setup by client

Pick your client and expand it. Claude clients come first, then Codex, Cursor, and any stdio-only harness.

/plugin marketplace add minim-l/brandize-mcp
/plugin install brandize@brandize

claude mcp add --transport http brandize https://brandize.me/api/mcp

codex plugin marketplace add minim-l/brandize-mcp
codex plugin add brandize@brandize

[mcp_servers.brandize]
url = "https://brandize.me/api/mcp"

{
  "mcpServers": {
    "brandize": {
      "url": "https://brandize.me/api/mcp"
    }
  }
}

{
  "mcpServers": {
    "brandize": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://brandize.me/api/mcp"]
    }
  }
}

Available tools

The free tools are always available. The logo-generation surface is a paid purchase.

Free

• echoHealth check that returns your message verbatim, confirming the endpoint is reachable.
• get_pricing_tiersList Brandize service tiers with their price and included features. Nothing is purchased.
• search_blogSearch Brandize logo-design and branding guides by keyword; returns titles, excerpts, and URLs.
• generate_color_paletteBuild a 5-color brand palette from a base hex color and harmony rule as CSS, Tailwind, or a hex list.
• generate_meta_tagsGenerate an HTML <head> meta-tag block (title, description, canonical, Open Graph, Twitter Card).
• generate_schema_markupGenerate a JSON-LD <script> block for a schema.org type (Organization, Article, FAQPage, Product, …).

Paid

• generate_logoGenerate a brand logo from a design brief. Returns a watermarked low-res preview and a checkout link; the full-resolution, watermark-free deliverable unlocks only after payment.
• get_logo_resultPoll a logo job by its jobToken. Once payment settles, returns a download URL for the full-resolution asset; otherwise a pending status.
• generate_logo_variationsFree preview of alternate style directions for an existing generate_logo job — watermarked, same as generate_logo. Metered by a free-preview credit (1 by default; a COMPLETE purchase grants 2 more). Before purchase, returns a variationId for each option to buy instead of the original; on an already-purchased COMPLETE job it adds more alternates to the deliverable itself.
• buy_logo_variationPurchase one of the alternate designs from generate_logo_variations instead of the original, at the PREMIUM price. Once paid, poll get_logo_result with the same jobToken.

Clients cache this tool list when they first connect. After a Brandize update, reconnect the connector to pick up new or changed tools — in Claude Code, run /mcp; in other clients, toggle the connector off and on or restart. Existing tool calls keep working in the meantime.

Example: calling a tool

Free tool: generate_color_palette

Every tool call is a standard MCP tools/call request. Here's generate_color_palette building a five-color palette from a base hex color:

{
  "method": "tools/call",
  "params": {
    "name": "generate_color_palette",
    "arguments": {
      "baseColor": "#3B82F6",
      "harmony": "complementary",
      "format": "hex"
    }
  }
}

The server replies with a text content block:

{
  "content": [
    {
      "type": "text",
      "text": "Primary: #3b82f6\nLight: #84b1f9\nDark: #0a59da\nComplement: #f6af3b\nComplement Light: #f9cd84"
    }
  ]
}

Every tool returns this same shape: a content array of text blocks, with an isError flag set on invalid input. Paid tools return the identical structure, with the text payload carrying a checkout link or job status instead of a palette.

Paid flow: generate_logo then get_logo_result

generate_logo takes a full design brief and immediately returns a watermarked preview and a checkout link. No file is delivered yet:

{
  "method": "tools/call",
  "params": {
    "name": "generate_logo",
    "arguments": {
      "brandName": "Kestrel Coffee",
      "whatItDoes": "Small-batch coffee roastery",
      "industry": "cafe-restaurant",
      "style": "minimalist",
      "layoutIntent": "wordmark",
      "primaryUseSurface": "storefront-sign",
      "colorPrimary": "#3B2A1E"
    }
  }
}

The response (trimmed here to the fields that matter):

{
  "jobToken": "00000000-0000-4000-8000-000000000000",
  "tier": "PREMIUM",
  "checkoutUrl": "https://brandize.me/pay/Xk93P2",
  "priceUsd": 5,
  "note": "Give the user checkoutUrl to pay, then poll get_logo_result with jobToken."
}

Hand the user checkoutUrl, then poll get_logo_result with the jobToken every few seconds. Before payment settles:

{ "status": "pending_payment", "retryAfterSeconds": 5 }

Once Stripe confirms payment:

{
  "status": "paid",
  "tier": "PREMIUM",
  "format": "zip",
  "assetUrl": "https://brandize.me/api/mcp/logo/00000000-0000-4000-8000-000000000000/zip"
}

assetUrl is a zip of the full-resolution PNG, vector SVG, and commercial license, the same deliverable described in Payment & consent below.

Payment & consent

generate_logo and buy_logo_variation are the paid paths. generate_logo returns a watermarked low-res preview and a Stripe checkout link priced at the current service tiers; buy_logo_variation mints a checkout at the PREMIUM price for a design already previewed by generate_logo_variations. Either way, the full-resolution, watermark-free deliverable (PNG, vector SVG, and commercial license) unlocks only after payment settles. Poll get_logo_result with the returned jobToken to retrieve it.

Consent is collected at checkout: the hosted Stripe page requires you to accept the Terms of Service and Privacy Policy before payment, so the tools neither gather consent nor surface these links themselves.

Troubleshooting