Skip to main content

MCP Server Setup

Connect your brand data to any AI tool using the Model Context Protocol (MCP). 55 tools, 6 resources, 3 prompts.

What is MCP (Model Context Protocol)?

MCP is an open standard that lets AI tools access external data sources. Brandfolio uses MCP to make your brand identity available to any AI tool that supports the protocol. This means you can:

  • Access your brand colors, typography, and voice guidelines from any AI tool
  • Generate content that matches your brand personality automatically
  • Check text and designs for brand compliance
  • Manage your brands, team members, and assets through AI
  • Get AI-powered suggestions for colors, voice, taglines, and personas
  • Upload and manage brand assets directly from your AI tool

How Authentication Works

Brandfolio uses OAuth 2.1 with PKCE for secure authentication. Here is what happens when you connect:

1. Connect

Your AI tool connects to Brandfolio's MCP endpoint

2. Authorize

A browser window opens for you to sign in and grant access

3. Auto-refresh

Tokens refresh automatically. No manual re-authentication needed

Setup Instructions

Claude Desktop Setup

Connect Brandfolio to Claude Desktop with OAuth authentication. Claude will automatically open a browser window for you to authorize access.

1Open Claude Desktop Settings

Go to Settings > Developer > Edit Config to open your MCP configuration file.

2Add the Brandfolio Server

Add this configuration to your claude_desktop_config.json file:

{
  "mcpServers": {
    "brandfolio": {
      "url": "https://www.brandfolio.app/api/mcp/u/mcp"
    }
  }
}

3Restart Claude Desktop

Close and reopen Claude Desktop. You should see a hammer icon indicating MCP tools are available.

4Authorize Access

When Claude first uses a Brandfolio tool, a browser window will open for OAuth authorization. Sign in with your Brandfolio account and authorize access. This only happens once.

5Start Using Your Brand

Try asking Claude: "List my brands" or "Get my brand guidelines". Claude will use Brandfolio's tools to access your brand data.

Usage Examples

  • "Write a LinkedIn post using my brand voice"
  • "What are my brand colors? Give me the hex values"
  • "Review this text for brand compliance"
  • "Suggest a new tagline for my brand"

Available Endpoints

Brandfolio provides two MCP endpoints depending on your use case:

Recommended/api/mcp/u/mcp

User-level endpoint. Access all your brands with 44 tools (read, write, AI suggestions, team management, assets). Requiresuser:brands scope.

/api/mcp/{brandId}/mcp

Brand-level endpoint. Read-only access to a single brand with 11 tools. Requires brand:read scope. Useful for sharing brand access with external collaborators.

What You Can Do

55 tools across 9 categories. See the full tool reference.

Read9 tools

Guidelines, colors, typography, voice, CSS, logo

Write7 tools

Update colors, typography, voice, identity, rules, UI

AI Suggestions4 tools

Colors, voice, tagline, personas

Team8 tools

Teams, members, invitations, roles

Members4 tools

Invite, list, remove, update roles

Assets4 tools

List, upload, update, delete brand assets

Lifecycle2 tools

Create and delete brands

Account5 tools

Profile, activity log, invitations

Sessions2 tools

List and revoke sessions

Troubleshooting

Server not showing in my AI tool

Make sure you've added the server configuration and restarted your application. Check that the URL is exactlyhttps://www.brandfolio.app/api/mcp/u/mcp

Authorization window doesn't open

Some AI tools need to be in "Agent mode" to trigger MCP connections. In VS Code, switch Copilot Chat to Agent mode. In Cursor, use Composer with Agent enabled.

Token expired or access denied

OAuth tokens refresh automatically. If you still get errors, remove the server from your config, restart, and re-add it to trigger a fresh authorization.

Need help?

Check our tool documentation for detailed information about each tool.