Model Context Protocol

Connect Braandly to any AI

The Braandly MCP server gives Claude, ChatGPT, Cursor, n8n, and any MCP client 53 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

Choose your tool. Each works as a remote connector over Streamable HTTP.

Tools

53 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).

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.

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.

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.

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.

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.

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: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: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: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
Starter400200
Plus1,000600
Pro2,0002,000
Ultimate4,0004,000
FAQs

MCP, answered

Endpointhttps://mcp.braandly.com/mcp·Full schema in the API reference

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%