Braandly brand management platform logo

Braandly

Features
Workspace & Collaboration
Brands Management
Brand Identity Tools
Assets Management
Brinks (Link in Bio)
Branding Tips & Guides
Tasks
Braandly AI
Docs
Brand Guidelines
Analytics & Insights
Projects
Integrations
All integrations
Figma Plugin
Chrome ExtensionFirefox Add-onEdge Add-on
Public API
MCP Server
Find Inspiration
Brands
Palettes
Gradients
Fonts
Resources
DevelopersBlogMCP ServerHelp Center
Pricing
Model Context Protocol

Connect Braandly to any AI

The Braandly MCP server gives Claude, ChatGPT, Cursor, n8n, and any MCP client 100 tools to manage workspaces, tasks, projects, docs, brand identity, and Brinks. Available on every plan.

Endpoint · Streamable HTTP

https://mcp.braandly.com/mcp
Authentication

Two ways to authenticate

Pick the method your client supports. Both reach the same tools and respect your plan limits.

OAuth 2.1 sign-in

Claude.ai · ChatGPT

Authorize with a secure browser flow (PKCE + dynamic client registration). No key to copy or store.

  • Nothing to copy, store, or rotate
  • Access follows your workspace role and plan limits
  • Revoke any client anytime from Settings → Connected Apps

API key header

Claude Code · Codex · Cursor · Windsurf · n8n

Send the ApiKey: bk_… header with a key from Settings → API Keys. Scopes control what each key can do.

  • Create read-only or read-write scoped keys
  • Each key respects your plan's rate limits
  • Rotate or revoke instantly; the key is shown once at creation
Setup

Connect your client

Pick your tool, then add Braandly in one click or with a single command. Every client connects over Streamable HTTP.

Claude Code

Read vs write access is controlled by your API key's scopes. Create a read-only key for read-only access.

Claude Code

OAuth or API key

Add Braandly with one CLI command. Sign in with OAuth, or use a key.

OAuth (recommended)

  1. 1Run the command below (no key), or add the config to .mcp.json.
  2. 2Sign in with Braandly in the browser when prompted.

Terminal (CLI)

claude mcp add --transport http braandly https://mcp.braandly.com/mcp

.mcp.json

{
  "mcpServers": {
    "braandly": {
      "type": "http",
      "url": "https://mcp.braandly.com/mcp"
    }
  }
}

Verify connection

claude mcp list
# braandly  ...  ✓ Connected
# or inside a session:
/mcp

API key

  1. 1Create an API key in Braandly under Settings → API Keys.
  2. 2Run the command, or add the config to .mcp.json.
  3. 3Replace bk_your_key_here with your key.

Terminal (CLI)

claude mcp add --transport http braandly https://mcp.braandly.com/mcp \
  --header "ApiKey: bk_your_key_here"

.mcp.json

{
  "mcpServers": {
    "braandly": {
      "type": "http",
      "url": "https://mcp.braandly.com/mcp",
      "headers": { "ApiKey": "bk_your_key_here" }
    }
  }
}
Tools

100 tools, across your whole workspace

List endpoints return slim summaries to stay within context limits; pass expand: "full" or fetch a single item for the complete body.

Workspaces

  • read
    list_workspaces

    List the workspaces the authenticated key can access.

  • read
    get_workspace

    Get a single workspace by id.

  • read
    list_workspace_members

    List members of a workspace.

  • read
    get_member

    Get a single workspace member by user id.

  • write
    update_workspace

    Update a workspace's settings (name, description, alias, color).

  • read
    get_workspace_stats

    Get productivity stats for a workspace (brand, project, task, doc, and asset counts).

  • read
    get_activity

    Get the recent activity / audit feed for a workspace.

Projects

  • read
    list_projects

    List projects in a workspace (summaries; expand for full).

  • read
    get_project

    Get a single project by id.

  • write
    create_project

    Create a project in a workspace.

  • write
    update_project

    Update a project.

  • write
    delete_project

    Delete a project.

  • read
    list_project_sections

    List task sections in a workspace or project.

  • write
    create_project_section

    Create a task section.

  • write
    update_project_section

    Update a task section.

  • write
    reorder_project_sections

    Move a task section to a new position.

  • write
    delete_project_section

    Delete a task section.

  • read
    list_project_members

    List the members of a project.

  • write
    add_project_member

    Add a workspace member to a project.

  • write
    update_project_member_role

    Change a project member's role.

  • write
    remove_project_member

    Remove a member from a project.

Tasks

  • read
    list_workspace_tasks

    List tasks across a workspace (summaries; expand for full).

  • read
    list_project_tasks

    List tasks in a project (summaries; expand for full).

  • read
    get_task

    Get a single task by id.

  • write
    create_task

    Create a task in a workspace (optionally in a project).

  • write
    update_task

    Update a task.

  • write
    delete_task

    Delete a task.

  • read
    list_tags

    List task tags in a workspace.

  • write
    create_tag

    Create a task tag.

  • write
    update_tag

    Update a task tag.

  • write
    delete_tag

    Delete a task tag.

  • read
    list_subtasks

    List the subtasks of a task.

  • write
    create_subtask

    Create a subtask under a task.

  • write
    update_subtask

    Update a subtask.

  • write
    complete_subtask

    Mark a subtask as completed.

  • write
    delete_subtask

    Delete a subtask.

Docs

  • read
    list_workspace_docs

    List workspace docs (summaries; expand for full content).

  • read
    get_doc

    Get a single workspace doc by id.

  • read
    list_personal_docs

    List the user's personal docs (summaries; expand for full content).

  • read
    get_personal_doc

    Get an authenticated user's personal doc by id.

  • write
    create_workspace_doc

    Create a doc in a workspace.

  • write
    update_workspace_doc

    Update a workspace doc.

  • write
    delete_workspace_doc

    Delete a workspace doc.

  • write
    duplicate_workspace_doc

    Duplicate a workspace doc.

  • read
    list_doc_tasks

    List the tasks linked to a workspace doc.

  • write
    attach_task_to_doc

    Link a task to a workspace doc (same workspace).

  • write
    detach_task_from_doc

    Unlink a task from a workspace doc.

  • write
    create_personal_doc

    Create a personal doc (Markdown or HTML).

  • write
    update_personal_doc

    Update a personal doc.

  • write
    delete_personal_doc

    Delete a personal doc.

  • write
    duplicate_personal_doc

    Duplicate a personal doc.

  • write
    convert_doc_scope

    Convert a doc between personal and workspace scope.

  • write
    share_doc

    Enable or disable public sharing for a workspace or personal doc.

  • write
    update_doc_sharing

    Update sharing settings for a shared workspace or personal doc.

  • write
    revoke_doc_sharing

    Revoke public sharing for a workspace or personal doc.

Brand Guidelines

  • read
    list_brand_guidelines

    List brand guidelines (summaries; expand for full blocks).

  • read
    get_brand_guideline

    Get a single brand guideline by id.

  • write
    create_brand_guideline

    Create a brand guideline in a workspace.

  • write
    update_brand_guideline

    Update a brand guideline.

  • write
    delete_brand_guideline

    Delete a brand guideline.

  • write
    update_brand_guideline_status

    Update a brand guideline's status (draft/pending/published/archived).

Brand Identity

  • read
    list_brand_identities

    List brand identities across accessible workspaces (summaries; expand for full).

  • read
    get_brand_identity

    Get the brand identity for a brand by slug.

  • write
    update_brand_identity

    Update a brand's identity (logo, colors, typography) by slug.

Workspace Brands

  • read
    list_workspace_brands

    List the brands in a workspace.

  • read
    get_workspace_brand

    Get a single workspace brand by slug.

  • write
    create_brand

    Create a brand in a workspace (name, services, and CEO required).

  • write
    update_brand

    Update a workspace brand by slug.

  • write
    archive_brand

    Toggle the archived state of a workspace brand.

  • write
    set_brand_visibility

    Set a workspace brand's visibility (public or private).

Brinks

  • read
    list_brinks

    List the Brinks the key can access.

  • read
    get_brink

    Get a single Brink by username.

  • write
    create_brink

    Create a Brink.

  • write
    update_brink

    Update a Brink by username.

  • write
    delete_brink

    Delete a Brink by username.

  • read
    get_brink_appearance

    Get a Brink's appearance (customization and settings).

  • write
    update_brink_appearance

    Update a Brink's appearance (background, buttons, fonts, layout).

  • read
    list_brink_subscribers

    List a Brink's subscribers (requires the subscribers scope).

  • read
    export_brink_subscribers

    Export a Brink's subscribers as CSV (requires the subscribers scope).

  • write
    add_brink_block

    Add a content block (link, image, text, etc.) to a Brink.

  • write
    update_brink_block

    Update a Brink block.

  • write
    reorder_brink_blocks

    Reorder a Brink's blocks.

  • write
    delete_brink_block

    Delete a Brink block.

Discover Public Assets

  • read
    search_brands

    Search the public brand catalog.

  • read
    search_palettes

    Search the public color-palette catalog.

  • read
    search_fonts

    Search the public font catalog.

  • read
    search_gradients

    Search the public gradient catalog.

  • read
    get_brand

    Get a single public catalog brand by slug.

  • read
    get_palette

    Get a single public catalog palette by slug.

  • read
    get_font

    Get a single public catalog font by slug.

  • read
    get_gradient

    Get a single public catalog gradient by slug.

  • read
    get_user_assets

    List the authenticated user's saved assets across workspaces.

Comments

  • read
    list_comments

    List comments on a task, project, brand, or other resource.

  • write
    create_comment

    Add a comment to a resource (Markdown or HTML).

  • write
    update_comment

    Update a comment.

  • write
    delete_comment

    Delete a comment.

Design Library

  • write
    save_palette

    Save or create a colour palette in a workspace's library.

  • write
    delete_palette

    Delete a saved or custom palette.

  • write
    save_gradient

    Save or create a gradient in a workspace's library.

  • write
    delete_gradient

    Delete a saved or custom gradient.

Permissions

Scopes control every key

Grant each key only the scopes it needs. Writes also require a workspace role of member or higher; guest keys are read-only and return a 403 on writes.

Read scopes

  • read:workspacesList and read workspaces.
  • read:membersList and read workspace members.
  • read:projectsList and read projects.
  • read:tasksList and read tasks.
  • read:docsList and read workspace and personal docs.
  • read:brand-guidelinesList and read brand guidelines.
  • read:brand-identityRead brand identity.
  • read:brinksList and read Brinks.
  • read:subscribersRead and export Brink subscribers.
  • read:commentsList and read comments.
  • read:brandsSearch the public brand catalog.
  • read:palettesSearch the public palette catalog.
  • read:fontsSearch the public font catalog.
  • read:gradientsSearch the public gradient catalog.

Write scopes

  • write:workspacesUpdate workspace settings.
  • write:projectsCreate, update, and delete projects.
  • write:tasksCreate, update, and delete tasks.
  • write:docsCreate, update, and delete docs.
  • write:brand-guidelinesCreate, update, and delete brand guidelines.
  • write:brand-identityUpdate brand identity.
  • write:brinksCreate, update, and delete Brinks.
  • write:commentsCreate, update, and delete comments.
  • write:palettesSave and delete palettes.
  • write:gradientsSave and delete gradients.
  • write:brandsManage saved brands.
Limits

Rate limits scale with your plan

The REST API and MCP server share the same per-plan limits, enforced over a 15-minute window and shown here per hour.

PlanReads / hourWrites / hour
Starter1,200600
Plus3,0001,800
Pro6,0006,000
Ultimate12,00012,000
FAQs

MCP, answered

Endpointhttps://mcp.braandly.com/mcp·Full schema in the API reference·Read the full MCP guide

Ready to get started?

Start Managing Your Brand Today

Create your brand workspace and organize everything your team needs.

Google Logo

Google

www.google.com

Tagline:

Our mission is to organize the world's information and make it universally accessible and useful.

Brand Score

80%

20.0%

2

+20.00%
vs last month