Back to Tool Reference
MCP

brand_dna.get

Return the persisted Brand DNA for the caller's organization.

Effectread-onlyScopebrand_dna:readPlanany plan

The audiences and niches arrays use the exact shapes brand_dna.set accepts and returns, so a get → edit → set round-trip is lossless.

Returns

has_brand_kitboolean

false when the org hasn't generated a Brand DNA yet. Remaining fields will be empty strings / empty lists (not null) so agents can inspect this flag once.

brand_descriptionstring

AI-generated summary of the brand identity.

user_brand_inputstring

Raw brand description the user originally provided.

colorsstring[]

Hex color codes.

typographystring

Typography guidance.

tonestring

Voice-and-tone descriptor.

product_typesstring[]

Product category names associated with the brand.

logo_urlstring | null

Fully-qualified CDN URL for the uploaded logo, or null if none.

logo_descriptionstring | null

AI description of the logo, or null if no logo.

audiencesobject[]

Target audiences. Each: key, label, age_range ("min-max" string), gender_options, ethnicity_options, description, is_preset, created_at. The key + gender_options are what you pass to virtual_model.generate / virtual_model.list and what drive VTO mockups. Virtual models are auto-generated when an audience is created.

nichesobject[]

Business niches driving trend discovery. Each: name, is_preset. Pass them back through brand_dna.set to keep them — omitting niches there replaces them with [].

Request
json
{
  "name": "brand_dna.get",
  "arguments": {}
}
Response
json
{
  "has_brand_kit": true,
  "brand_description": "Velvet Orbit Apparel is an edgy, cybercore-infused streetwear brand merging deep-space aesthetics with alternative internet subcultures. The brand specializes in oversized silhouettes featuring high-contrast, celestial and UFO-themed…",
  "user_brand_input": "Velvet Orbit Apparel is an edgy streetwear brand that collides deep-space aesthetics with alternative internet subcultures. Featuring high-contrast, UFO and celestial-themed graphics on oversized garments, the brand caters to Gen Z…",
  "colors": [
    "#050505",
    "#B026FF"
  ],
  "typography": "Futuristic, extended sans-serif with technical elements",
  "tone": "Mysterious, rebellious, and digitally native",
  "product_types": [
    "Tees",
    "Hoodies"
  ],
  "logo_url": null,
  "logo_description": null,
  "audiences": [
    {
      "key": "alt-astrology_enthusiasts",
      "label": "Alt-Astrology Enthusiasts",
      "age_range": "18-28",
      "gender_options": [
        "women",
        "men"
      ],
      "ethnicity_options": [
        "Black",
        "White"
      ],
      "description": "Consumers who blend spiritual and astrological interests with a darker, edgier aesthetic. They reject mainstream boho-chic astrology in favor of mysterious, cosmic, and high-contrast visual representations.",
      "is_preset": false,
      "created_at": "2026-07-08T21:09:06.019790+00:00"
    },
    {
      "key": "gen_z_cyber-streetwear_adopters",
      "label": "Gen Z Cyber-Streetwear Adopters",
      "age_range": "16-26",
      "gender_options": [
        "men",
        "women"
      ],
      "ethnicity_options": [
        "Black",
        "White"
      ],
      "description": "Highly engaged in internet subcultures, TikTok fashion trends, and underground digital music scenes. They prefer oversized, statement-making silhouettes and are drawn to niche, graphic-heavy apparel that signals in-group identity.",
      "is_preset": false,
      "created_at": "2026-07-08T21:09:06.011566+00:00"
    }
  ],
  "niches": [
    {
      "name": "Alt-Fashion",
      "is_preset": false
    },
    {
      "name": "Cybercore",
      "is_preset": false
    }
  ]
}