MCP Tools
Context & Resources

get_brand_foundation

Return the team's Brand Foundation: company overview, brand voice, writing style, and writing examples. Call it whenever the user asks about, or wants you to use, their brand voice, company information, or writing style.

Parameters

NameTypeRequiredDefaultDescription
elementsarray of stringNo—Optional subset of elements to return. Omit or pass empty to return all four.

Input Schema

{
  "type": "object",
  "properties": {
    "elements": {
      "type": "array",
      "items": {
        "enum": [
          "company_overview",
          "brand_voice",
          "writing_style",
          "writing_examples"
        ],
        "type": "string"
      },
      "description": "Optional subset of elements to return. Omit or pass empty to return all four."
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "link_url": {
      "type": "string",
      "description": "Deep-link to the Brand Foundation section in the Marcora web app. Always present."
    },
    "brand_voice": {
      "type": "string",
      "description": "Markdown content for Brand Voice. Empty string if not set. Only present if requested via elements."
    },
    "writing_style": {
      "type": "string",
      "description": "Markdown content for Writing Style. Empty string if not set. Only present if requested via elements."
    },
    "company_overview": {
      "type": "string",
      "description": "Markdown content for Company Overview. Empty string if not set. Only present if requested via elements."
    },
    "writing_examples": {
      "type": "string",
      "description": "Markdown content for Writing Examples. Free-form structure — whatever the user has saved. Empty string if not set. Only present if requested via elements."
    }
  }
}

Instructions

Returns the team's Brand Foundation — the foundational brand and company information that guides all AI-generated content. The four elements are:

  • company_overview — general information about the company
  • brand_voice — tone, core values, mission, and personality
  • writing_style — language complexity, sentence structure, formatting preferences, CTA style
  • writing_examples — sample content demonstrating the team's distinctive voice (free-form structure; users organize this however they like)

When to use it: call it whenever the user asks about — or wants the agent to use — their brand voice, company overview, writing style, or writing examples (e.g. "What is our brand voice?", "What is the brand voice of <company>?", "Summarize our company overview"). These four elements live ONLY here — get_relevant_context's relevancy search does not surface Brand Foundation, so this is the correct tool for any brand-voice / company-overview / writing-style / writing-examples question, not relevancy search.

By default returns all four elements. Pass elements to scope the response to a subset. The response is structured JSON — paste it directly into a downstream AI prompt (modern LLMs read JSON fine) or template-string the fields into markdown if you prefer.

Note: You don't need to call this before create_content or create_plan — those pull Brand Foundation in automatically. Call it directly whenever the user wants to see, discuss, or hand off their Brand Foundation.

Privacy: Team-scoped via $auth.id → current_team_id. Users can only read their own team's Brand Foundation.

Parameters

Parameter Type Required Description
elements array of enum No Optional subset of elements to return. Values: company_overview, brand_voice, writing_style, writing_examples. Omit or pass empty to return all four.

Output

Field Type Description
company_overview string Markdown content for Company Overview. Empty string if not set. Only present if requested via elements.
brand_voice string Markdown content for Brand Voice. Empty string if not set. Only present if requested via elements.
writing_style string Markdown content for Writing Style. Empty string if not set. Only present if requested via elements.
writing_examples string Markdown content for Writing Examples. Free-form structure — whatever the user has saved. Empty string if not set. Only present if requested via elements.
link_url string Deep-link that opens the Brand Foundation section in the Marcora web app (where the user can toggle between the four elements). Always present.

Example prompts

  • "What's my brand foundation?"
  • "Show me my company's brand voice"
  • "Just show me my writing style and writing examples"

See also: Use update_brand_foundation to overwrite a single element's content.

Links: present link_url to the user exactly as returned — copy it character for character. Never retype, shorten, or rebuild a link or the IDs inside it.

Scroll to Top