MCP Tool Reference

Complete reference for all 43 user-level tools, 7 resources, and 3 prompts available via Brandfolio's MCP server.

Endpoint: https://www.brandfolio.app/api/mcp/u/mcp · Auth: OAuth 2.1 with PKCE

Brand Discovery

1 tool

list_brandsread

Returns all brands owned by the authenticated user.

Brand Read

8 tools

get_brand_guidelinesread

Complete brand guidelines as structured markdown.

brandId

get_color_paletteread

Colors with hex values, CSS variables, and usage guidance.

brandId

get_typographyread

Font settings with Google Fonts URL, CSS variables, @font-face.

brandId

get_voice_guidelinesread

Voice summary, tone preset, dos, donts, and examples.

brandId

check_brand_complianceread

Analyzes text against brand voice. Quick (keyword) or deep (AI) mode.

brandId, text, context?, mode?

get_css_variablesread

All brand CSS variables combined for colors, typography, and UI.

brandId

get_brand_summaryread

Concise human-readable brand summary in markdown.

brandId

get_logoread

Brand logo URLs. Supports variant selection (icon, withName, withTagline).

brandId, variant?

Brand Write

5 tools

update_colorswrite

Update brand color palette. Pass only colors to change.

brandId, primary?, secondary?, accent?, background?, text?, ctaBackground?, ctaText?

update_typographywrite

Update typography: heading font, body font, preset, icon library.

brandId, headingFont?, bodyFont?, preset?, iconLibrary?

update_voicewrite

Update voice guidelines. Arrays replace entirely when provided.

brandId, summary?, preset?, dos?, donts?, customExamples?

update_identitywrite

Update name, description, personality, tagline.

brandId, name?, description?, personality?, tagline?

update_uiwrite

Update UI: button radius, shadows, spacing, card styles.

brandId, buttonRadius?, buttonShadow?, spacing?, cardRadius?, cardShadow?, cardBorder?

Brand Lifecycle

2 tools

create_brandwrite

Create a new brand. Authenticated user becomes owner.

name, description, colors, typography, personality?, tagline?, voice?, ui?

delete_brandwrite

Permanently delete a brand. Owners only. Requires confirmation.

brandId

AI Suggestions

4 tools

suggest_colorsread

AI-generated color palette from brand description. Does not persist.

description, personality?, targetAudience?

suggest_voiceread

AI-generated voice guidelines. Does not persist.

description, brandName?, personality?, targetAudience?, voicePreset?

suggest_taglineread

AI-generated tagline (max 8 words). Does not persist.

brandName, description, personality?, targetAudience?

suggest_personasread

AI-generated buyer personas (B2B, B2C, or hybrid). Does not persist.

description, personality, businessModel, brandName?, marketFocus?

Members

4 tools

invite_memberwrite

Invite a user by email. Owners and admins only.

brandId, email, role

list_membersread

List all members with roles. Admins see pending invitations.

brandId

remove_memberwrite

Remove a member. Owners only. Cannot remove last owner.

brandId, targetUserId

update_member_rolewrite

Change a member's role. Owners only.

brandId, targetUserId, newRole

Assets

4 tools

get_brand_assetsread

Brand assets with download URLs. Filter by category or role.

brandId, category?, role?

update_asset_metadatawrite

Update name, tags, sort order, or role of an asset.

brandId, assetId, name?, tags?, sortOrder?, role?

delete_assetwrite

Permanently delete a brand asset from storage and database.

brandId, assetId

batch_upload_assetswrite

Upload multiple assets from public URLs (max 20 per call).

brandId, assets[]

Teams

8 tools

list_teamsread

All teams the authenticated user belongs to.

get_teamread

Detailed team info with member and brand counts.

teamId

list_team_membersread

All members of a team with roles.

teamId

invite_team_memberwrite

Invite a user to a team by email.

teamId, email, role

update_team_member_rolewrite

Change a team member's role.

teamId, targetUserId, newRole

remove_team_memberwrite

Remove a member from a team.

teamId, targetUserId

list_team_invitationsread

All pending invitations for a team.

teamId

revoke_team_invitationwrite

Revoke a pending team invitation.

teamId, invitationId

Account & Sessions

7 tools

get_profileread

Authenticated user's profile (name, email, avatar).

update_profilewrite

Update the user's display name.

name

get_activity_logread

Paginated activity log. Filter by category and brand.

category?, brandId?, cursor?, limit?

list_invitationsread

All pending invitations sent by the user.

brandId?

revoke_invitationwrite

Revoke a pending invitation.

invitationId

list_sessionsread

All active sessions. IPs masked for privacy.

revoke_sessionwrite

Revoke a session by ID.

sessionId

Resources

Resources are read-only data endpoints using the brandfolio:// URI scheme. Available on the brand-level endpoint.

brandbrandfolio://brand

Complete brand data: identity, colors, typography, voice, UI, assets.

identitybrandfolio://identity

Brand name, description, personality, tagline, logo, persona.

colorsbrandfolio://colors

Color palette with CSS variables.

typographybrandfolio://typography

Font settings with files, @font-face CSS, Google Fonts URL, CSS variables.

voicebrandfolio://voice

Voice and tone: preset, summary, dos, donts, examples.

uibrandfolio://ui

UI component settings with CSS variables.

assetsbrandfolio://assets

All brand assets grouped by category with download URLs.

Prompts

Prompts are pre-built templates that set brand context for content creation and review. Available on the brand-level endpoint.

brand-voice-guide

Voice and tone guidelines for on-brand content creation.

contentType? (email, social, blog, ad, landing-page, general)

on-brand-review

Reviews text against brand guidelines. Returns compliance score and revised version.

text (required)

brand-introduction

Introduces complete brand identity to set context for any task.

none

Setup instructions for Claude Desktop, Cursor, VS Code, and Windsurf