Brandfolder MCP server Let your AI agent organize your Brandfolder.

ToolWhat it doesAccess

• list_brandfolders List the Brandfolders your account can open. read

  Returns each Brandfolder with its ID, slug, name and asset count, in the order Brandfolder shows them. Only Brandfolders your login can open are listed. Use the ID or slug as brandfolder in the other tools.

  MCP callbrandfolder_read → list_brandfolders

  REST endpointGET https://cotlet.dev/api/v1/brandfolder/brandfolders

  Parameters

  Parameters: list_brandfolders

  Name	Type	Description
  search string	string	Part of a Brandfolder name.

  Example response

  {
    "brandfolders": [
      {
        "id": "oqg5b8-9c1l2k-4xv0ng",
        "slug": "yourbrand",
        "name": "Yourbrand",
        "asset_count": 842
      },
      {
        "id": "p2h7d1-3m8n5q-6zt9ab",
        "slug": "yourbrand-events",
        "name": "Yourbrand Events",
        "asset_count": 119
      }
    ]
  }

• list_sections List the sections of a Brandfolder. read

  Returns each section with its ID, name and default asset type, in Brandfolder order. Sections hold the assets and group them in the Brandfolder. Use the section ID in add_asset and search_assets.

  MCP callbrandfolder_read → list_sections

  REST endpointGET https://cotlet.dev/api/v1/brandfolder/sections

  Parameters

  Parameters: list_sections

  Name	Type	Description
  brandfolder string required	string	Brandfolder ID or slug from list_brandfolders.

  Example input

  {
    "brandfolder": "brandfolder"
  }

  Example response

  {
    "sections": [
      {
        "id": "sx7k2m-4d9f1a-8bq3pw",
        "name": "Logos",
        "default_asset_type": "GenericFile"
      },
      {
        "id": "sy1c8n-2e5g7b-9ur4qz",
        "name": "Product shots",
        "default_asset_type": "GenericFile"
      }
    ]
  }

• list_collections List the collections of a Brandfolder. read

  Returns each collection you are a member of with its ID, name, tagline and asset count. A collection holds a subset of assets without copying them, and you must be a member of it to search inside it.

  MCP callbrandfolder_read → list_collections

  REST endpointGET https://cotlet.dev/api/v1/brandfolder/collections

  Parameters

  Parameters: list_collections

  Name	Type	Description
  brandfolder string required	string	Brandfolder ID or slug from list_brandfolders.

  Example input

  {
    "brandfolder": "brandfolder"
  }

  Example response

  {
    "collections": [
      {
        "id": "cn4r9t-7h2j5d-1wk8ys",
        "name": "Spring Launch",
        "tagline": "Assets for the April campaign",
        "asset_count": 36
      }
    ]
  }

• search_assets Search the assets of a Brandfolder, a section or a collection. read

  Returns each asset with its ID, name, description, tags, section and created date. Pages follow the order Brandfolder returns them, and total says how many assets match. Searching inside a collection needs your account to be a member of it.

  MCP callbrandfolder_read → search_assets

  REST endpointGET https://cotlet.dev/api/v1/brandfolder/assets/search

  Parameters

  Parameters: search_assets

  Name	Type	Description
  brandfolder string required	string	Brandfolder ID or slug from list_brandfolders.
  query string	string	Search text. To filter on a custom field use custom_fields.{key}:"{value}".
  section_id string	string	Only assets in this section, from list_sections.
  collection_id string	string	Only assets in this collection, from list_collections.
  page integer	integer	Page number, starting at 1.
  per integer	integer	Assets per page. Default 100, maximum 3000.

  Example input

  {
    "brandfolder": "brandfolder"
  }

  Example response

  {
    "total": 2,
    "page": 1,
    "assets": [
      {
        "id": "as3d8f-1k6m2p-5vy7ct",
        "name": "Spring hero banner",
        "tags": [
          "banner",
          "spring"
        ],
        "section": "Product shots",
        "created_at": "2026-11-05T09:12:44Z"
      },
      {
        "id": "as4e9g-2l7n3q-6wz8du",
        "name": "Logo pack 2026",
        "tags": [],
        "section": "Logos",
        "created_at": "2026-11-04T16:03:10Z"
      }
    ]
  }

• get_asset Read one asset with its attachments, tags and custom fields. read

  Returns the name, description, tags, custom fields, availability dates and the attachments with file name and CDN URL. The CDN URL returns 404 while the asset is pending approval or unpublished. Whether you get a CDN URL depends on your Brandfolder plan.

  MCP callbrandfolder_read → get_asset

  REST endpointGET https://cotlet.dev/api/v1/brandfolder/assets/{asset_id}

  Parameters

  Parameters: get_asset

  Name	Type	Description
  asset_id string required	string	Asset ID from search_assets.

  Example input

  {
    "asset_id": "asset_8c41d2"
  }

  Example response

  {
    "id": "as3d8f-1k6m2p-5vy7ct",
    "name": "Spring hero banner",
    "description": "Homepage banner, 1600 by 600",
    "tags": [
      "banner",
      "spring"
    ],
    "custom_fields": {
      "Campaign": "Spring Launch"
    },
    "attachments": [
      {
        "filename": "spring-hero.png",
        "cdn_url": "https://cdn.example.com/spring-hero.png"
      }
    ]
  }

• list_custom_fields List the custom field keys of a Brandfolder with their allowed values. read

  Returns each custom field key and its values. When controlled custom fields are on, set_custom_field accepts only the allowed values listed here.

  MCP callbrandfolder_read → list_custom_fields

  REST endpointGET https://cotlet.dev/api/v1/brandfolder/custom-fields

  Parameters

  Parameters: list_custom_fields

  Name	Type	Description
  brandfolder string required	string	Brandfolder ID or slug from list_brandfolders.

  Example input

  {
    "brandfolder": "brandfolder"
  }

  Example response

  {
    "custom_fields": [
      {
        "key": "Campaign",
        "values": [
          "Spring Launch",
          "Summer Sale"
        ]
      },
      {
        "key": "Usage rights",
        "values": [
          "Internal",
          "Public"
        ]
      }
    ]
  }

ToolWhat it doesAccess

• add_asset Create an asset in a section from a public file URL. write

  Returns the new asset ID and the section it landed in. The file must sit at a public URL; files on your computer are not uploaded. It adds to your library and reaches no one, so it does not wait for your OK; delete_asset removes it.

  MCP callbrandfolder_write → add_asset

  REST endpointPOST https://cotlet.dev/api/v1/brandfolder/sections/{section_id}/assets

  Parameters

  Parameters: add_asset

  Name	Type	Description
  brandfolder string required	string	Brandfolder ID or slug from list_brandfolders.
  section_id string required	string	Section that receives the asset, from list_sections.
  name string required	string	Asset name.
  url string required	string	Public URL of the file. It must stay reachable for a couple of hours.
  filename string required	string	File name with extension.
  description string	string	Asset description.

  Example input

  {
    "brandfolder": "yourbrand",
    "section_id": "sy1c8n-2e5g7b-9ur4qz",
    "name": "Autumn hero banner",
    "url": "https://example.com/files/autumn-hero.png",
    "filename": "autumn-hero.png",
    "description": "Homepage banner, 1600 by 600"
  }

  Example response

  {
    "asset_id": "as5f0h-3m8o4r-7xa9ev",
    "name": "Autumn hero banner",
    "section": "Product shots",
    "attachments": 1
  }

• tag_asset Add tags to an asset. write

  Returns the asset tags after the change. Tags you pass are added to the ones already there. It reaches no one and the extra tags can be removed in the app, so it does not wait for your OK.

  MCP callbrandfolder_write → tag_asset

  REST endpointPOST https://cotlet.dev/api/v1/brandfolder/assets/{asset_id}/tag

  Parameters

  Parameters: tag_asset

  Name	Type	Description
  asset_id string required	string	Asset ID from search_assets.
  tags array required	array	Tag names to add.

  Example input

  {
    "asset_id": "asset_8c41d2",
    "tags": "tags"
  }

  Example response

  {
    "asset_id": "as4e9g-2l7n3q-6wz8du",
    "tags": [
      "logo",
      "brand",
      "pack"
    ]
  }

• set_custom_field Set the value of a custom field on an asset. write

  Returns the asset custom fields after the change. A key that is not in the Brandfolder fails when controlled custom fields are on. It reaches no one and you can set the old value back, so it does not wait for your OK.

  MCP callbrandfolder_write → set_custom_field

  REST endpointPUT https://cotlet.dev/api/v1/brandfolder/assets/{asset_id}/custom-field

  Parameters

  Parameters: set_custom_field

  Name	Type	Description
  asset_id string required	string	Asset ID from search_assets.
  key string required	string	Custom field key from list_custom_fields.
  value string required	string	Field value. With controlled custom fields it must be an allowed value.

  Example input

  {
    "asset_id": "asset_8c41d2",
    "key": "key",
    "value": "value"
  }

  Example response

  {
    "asset_id": "as4e9g-2l7n3q-6wz8du",
    "custom_fields": {
      "Campaign": "Spring Launch"
    }
  }

• create_collection Create a collection in a Brandfolder. write

  Returns the collection ID and name. A collection is a way to organize, share and restrict a subset of assets, so create it empty and fill it with add_to_collection. It reaches no one until someone is given access, so it does not wait for your OK.

  MCP callbrandfolder_write → create_collection

  REST endpointPOST https://cotlet.dev/api/v1/brandfolder/collections

  Parameters

  Parameters: create_collection

  Name	Type	Description
  brandfolder string required	string	Brandfolder ID or slug from list_brandfolders.
  name string required	string	Collection name.
  tagline string	string	Short line under the name.

  Example input

  {
    "brandfolder": "brandfolder",
    "name": "Jane Doe"
  }

  Example response

  {
    "collection_id": "cn4r9t-7h2j5d-1wk8ys",
    "name": "Spring Launch",
    "asset_count": 0
  }

• add_to_collection Put existing assets in a collection without copying them. writeasks first

  Returns how many assets were added and the new asset count of the collection. The assets stay in their sections. Members of the collection see them, so the call waits for your OK.

  MCP callbrandfolder_write → add_to_collection

  REST endpointPOST https://cotlet.dev/api/v1/brandfolder/collections/{collection_id}

  Parameters

  Parameters: add_to_collection

  Name	Type	Description
  collection_id string required	string	Collection ID from list_collections.
  asset_ids array required	array	Asset IDs from search_assets.

  Example input

  {
    "collection_id": "collection_8c41d2",
    "asset_ids": "asset ids"
  }

  Example response

  {
    "collection_id": "cn4r9t-7h2j5d-1wk8ys",
    "added": 2,
    "asset_count": 2
  }

ToolWhat it doesAccess

• create_share_link Create a share link for assets, as the share button does. writeasks first

  Returns the link URL with its name and the options it was created with. The options are the ones Brandfolder shows in the share dialog. Anyone who gets the URL can open it as the options allow, so the call waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callbrandfolder_write → create_share_link

  REST endpointPOST https://cotlet.dev/api/v1/brandfolder/share-links

  Parameters

  Parameters: create_share_link

  Name	Type	Description
  brandfolder string required	string	Brandfolder ID or slug from list_brandfolders.
  asset_ids array required	array	Assets to share, from search_assets.
  name string	string	Custom name of the link.
  private boolean	boolean	True for "Make link private": only people with a Brandfolder login or Guest Passkey see the assets.
  disable_download boolean	boolean	True for view-only: people can look but not download or share.
  expires_at string	string	Date the link stops working, as YYYY-MM-DD.

  Example input

  {
    "brandfolder": "brandfolder",
    "asset_ids": "asset ids"
  }

  Example response

  {
    "url": "https://brandfolder.com/s/example-logo-pack",
    "name": "Logo pack for Acme",
    "assets": 1,
    "private": true,
    "disable_download": true,
    "expires_at": "2026-11-30"
  }

• delete_asset Delete an asset from a Brandfolder. writeasks first

  Returns the deleted asset ID. The asset leaves its sections and collections, and share links that include it lose it. Other people use these assets, so the call waits for your OK. By default you confirm each call; you can switch that off for this tool.

  MCP callbrandfolder_write → delete_asset

  REST endpointDELETE https://cotlet.dev/api/v1/brandfolder/assets/{asset_id}

  Parameters

  Parameters: delete_asset

  Name	Type	Description
  asset_id string required	string	Asset ID from search_assets.

  Example input

  {
    "asset_id": "asset_8c41d2"
  }

  Example response

  {
    "asset_id": "as5f0h-3m8o4r-7xa9ev",
    "deleted": true
  }