--- title: "update_brand_kit. Metadata MCP tool reference" url: https://metadata.io/developers/tools/update_brand_kit description: "Update existing brand kit with brand DNA parameters. Destructive tool on the Metadata MCP server, with its full JSON Schema." source: metadata.io --- # update_brand_kit Update existing brand kit with brand DNA parameters. Destructive [creative](https://metadata.io/developers/tools/#cat-creative) ## What it does ## Arguments | Argument | Type | | Notes | |---|---|---|---| | `company_url` | string | required | Company website URL or domain (e.g. 'ambient.ai'). | | `long_description` | string | | Company description for marketing use. | | `logo_url` | string | | Direct URL to a single company logo image (back-compat; prefer logo_urls). Setting a permanent brand logo requires elevated Metadata permissions. | | `logo_urls` | array | | One or more direct URLs to logo images to set as the brand's permanent logo(s). Each uploaded logo is automatically expanded into clean, persisted variants (transparent, high-res, and both a light and dark version when the mark is a single color) so generated creatives have multiple usable options. | | `remove_old_logos` | boolean | | When true (default), replace the brand's existing logos with the provided ones; when false, append to them. | | `search_keywords` | array | | SEO/search keywords for the brand. | | `website_background` | string | | 6-digit hex color (e.g. '#FFFFFF') of the brand website's background. generate_brand_creative uses it as the default dominant background for ads (use_website_background). Set it when the user wants ads to match their site's background or the auto-detected value is wrong. | | `colors` | array | | Legacy flat color list. Each: {hex (with #), type, name?}. | | `fonts` | array | | Legacy flat font list. Each: {name, type}. | | `primary_colors` | array | | Primary color palette. | | `accent_colors` | array | | Accent color palette. | | `extended_palette` | array | | Extended grayscale palette. | | `semantic_colors` | array | | Semantic/status colors. | | `primary_font` | string | | Primary font family name. | | `primary_font_usage` | string | | Primary font usage description. | | `secondary_font` | string | | Secondary/display font family name. | | `secondary_font_usage` | string | | Secondary font usage description. | | `headline_font` | string | | Headline font family. | | `headline_weight` | string | | Headline font weight. | | `headline_size` | string | | Headline font size range. | | `headline_case` | string | | Headline text case rule. | | `headline_linespace` | string | | Headline line spacing. | | `headline_letterspace` | string | | Headline letter spacing. | | `eyebrow_font` | string | | Eyebrow font family. | | `eyebrow_weight` | string | | Eyebrow font weight. | | `eyebrow_case` | string | | Eyebrow text case rule. | | `eyebrow_linespace` | string | | Eyebrow line spacing. | | `eyebrow_letterspace` | string | | Eyebrow letter spacing. | | `subtitle_font` | string | | Subtitle font family. | | `subtitle_weight` | string | | Subtitle font weight. | | `subtitle_linespace` | string | | Subtitle line spacing. | | `subtitle_letterspace` | string | | Subtitle letter spacing. | | `body_font` | string | | Body text font family. | | `body_weight` | string | | Body text font weight. | | `body_size` | string | | Body text font size. | | `body_linespace` | string | | Body text line spacing. | | `body_letterspace` | string | | Body text letter spacing. | | `cta_font` | string | | CTA/button font family. | | `cta_weight` | string | | CTA/button font weight. | | `cta_size` | string | | CTA/button font size. | | `cta_linespace` | string | | CTA/button line spacing. | | `cta_letterspace` | string | | CTA/button letter spacing. | | `logo_on_dark` | string | | Logo color rule on dark backgrounds. | | `logo_on_light` | string | | Logo color rule on light backgrounds. | | `logo_clear_space` | string | | Logo clear space rule. | | `logo_misuse` | array | | List of logo misuse rules. | | `button_shape` | string | | Button shape description. | | `button_background` | string | | Button background style. | | `button_text_color` | string | | Button text color rule. | | `button_text_weight` | string | | Button text weight. | | `button_text_case` | string | | Button text case. | | `button_padding` | string | | Button padding. | | `standard_ctas` | array | | Standard CTA labels. | | `cta_placement` | string | | CTA placement guidance. | | `tagline` | string | | Primary brand tagline. | | `tagline_variants` | array | | Alternative taglines. | | `tagline_placement` | string | | Tagline placement guidance. | | `visual_motifs` | array | | Brand visual motifs. | | `promotional_elements` | array | | Promotional proof points. | | `tone` | string | | Brand tone description. | | `value_propositions` | array | | Core value propositions. | | `headline_formulas` | array | | Headline writing patterns. | | `proof_points` | array | | Evidence/social proof items. | | `product_names` | object | | Product name mapping (e.g. {platform: 'X', vlm: 'Y'}). | | `content_hierarchy_order` | array | | Content element ordering. | | `content_hierarchy_spacing` | string | | Section spacing guidance. | | `content_hierarchy_text_max_width` | string | | Max text block width. | | `photography_style` | string | | Photography style description. | | `photography_subjects` | array | | Recommended photo subjects. | | `photography_treatment` | string | | Photo treatment rules. | | `photography_avoid` | string | | Photography anti-patterns. | | `dos` | array | | Brand 'do' rules. | | `donts` | array | | Brand 'don't' rules. | | `primary_layouts` | array | | Layout system definitions. | | `channel_linkedin` | object | | LinkedIn channel config. | | `channel_facebook` | object | | Facebook channel config. | | `channel_display` | object | | Display ads channel config. | ## Request **Request template, not a complete runnable example.** Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool. ## Response ## Related Other creative tools: - [archive_ad](https://metadata.io/developers/tools/archive_ad) Destructive - [create_update_carousel_ad](https://metadata.io/developers/tools/create_update_carousel_ad) Destructive - [create_update_convo_ad](https://metadata.io/developers/tools/create_update_convo_ad) Destructive - [create_update_document_ad](https://metadata.io/developers/tools/create_update_document_ad) Destructive - [create_update_google_ads_ad](https://metadata.io/developers/tools/create_update_google_ads_ad) Destructive - [create_update_image_ad](https://metadata.io/developers/tools/create_update_image_ad) Destructive - [create_update_linkedin_message_ad](https://metadata.io/developers/tools/create_update_linkedin_message_ad) Destructive - [create_update_microsoft_ads_ad](https://metadata.io/developers/tools/create_update_microsoft_ads_ad) Destructive [Browse the tool catalog](https://metadata.io/developers/tools/) ยท [machine-readable index](https://metadata.io/developers/tools.json)