braaand-mcp

MCP server for Braaand — exposes brand data, assets, templates, projects, and rendering as tools for Claude.

Install

npm install -g braaand-mcp

Setup

Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "braaand": {
      "command": "braaand-mcp"
    }
  }
}

Shares credentials with the CLI — run braaand auth login first.

Tools

Identity

| Tool | Description | |------|-------------| | whoami | Return the authenticated identity and brand counts. |

Brands

| Tool | Description | |------|-------------| | list_brands | List all accessible brands. | | get_brand_info | Full brand dump: config + assets with URLs. | | update_brand | Update brand name/description. | | delete_brand | Owner-only. Requires confirmBrandId === brandId. |

Brand config & knowledge

| Tool | Description | |------|-------------| | get_brand_config | Colors, fonts, type styles, voice, logo system. | | update_brand_config | Partial config update (only changed fields). | | get_brand_knowledge | Structured knowledge sections. |

Assets

| Tool | Description | |------|-------------| | list_assets | All assets with direct URLs; optional type filter. | | get_asset | Asset metadata. | | upload_asset | Upload file (prefer filePath over base64). | | delete_asset | Delete an asset. |

Templates

| Tool | Description | |------|-------------| | list_templates | List brand templates. | | get_template | Full template definition. | | discover_templates | Agent-facing catalog. | | delete_template | Delete with usage-check safety. | | list_system_templates | System (brand-agnostic) templates. | | instantiate_template | Copy a system template into a brand. |

Projects & ad sets

| Tool | Description | |------|-------------| | list_projects | List campaigns for a brand. | | get_project | Project with all ad sets and ads. | | create_project | Create a project. | | update_project | Update project fields. | | delete_project | Cascades to all ad sets and ads. | | list_adsets | Ad sets within a project. | | get_adset | Ad set with all ads. | | create_adset | Create an ad set with optional ads. | | update_adset | Update ad set fields. | | delete_adset | Delete an ad set. |

Rendering

| Tool | Description | |------|-------------| | render | Render one ad, save PNG locally, return path. | | render_batch | Render every ad in an ad set across formats. |

Rendered PNGs are saved to ~/.braaand/renders/ by default. Use the outputPath/outputDir parameter to override.

More

See braaand.ai for full documentation.