Referenz der MCP-Tools

Diese Seite listet alle Tools und Resources, die der MCP-Server Brandhub (Version 1.1.0) anbietet. Sie entsteht direkt aus der Server-Definition und zeigt damit den ausgelieferten Stand.

Lese-Tools brauchen einen Key mit Leserecht, Schreib-Tools einen mit Schreibrecht. Der Key legt auch die Marke fest, auf die sich alle Aufrufe beziehen.

search_website erscheint nur, wenn für die Marke das Modul „Markenagent (KI)“ aktiv und eine Website eingelesen ist.

Tools

get_brand

Stammdaten und Theme der Marke: Name, Farben und Schriften je Rolle mit Schnitten. Zu Beginn einer Aufgabe aufrufen, um die Marke zu kennen, oder bei Fragen wie „Welche Hausschrift nutzen wir?“. Für vollständige Farbwerte get_brand_colors nehmen.

Eigenschaften: nur lesend, idempotent, nicht greift auf externe Systeme zu.

Keine Parameter.

get_brand_colors

Markenfarben. Ohne Parameter eine schlanke Liste (id, name, role, description), genug, um eine Farbe auszuwählen. Die Werte (HEX, RGB, CMYK, Pantone, RAL, Abstufungen) liefert eine Farbe per id oder die ganze Liste mit expand=full. Beispiel: „Welchen HEX-Wert hat unser Primärblau?“ Werte unverändert übernehmen, nie schätzen.

Eigenschaften: nur lesend, idempotent, nicht greift auf externe Systeme zu.

Parameter	Typ	Pflicht	Beschreibung
id	integer	nein	Optional: eine Farbe über ihre stabile ID (liefert alle Werte).
role	string	nein	Optional: nur Farben mit dieser Rolle (primary, secondary, …).
name	string	nein	Optional: exakter Farbname.
expand	string	nein	Optional: “full” liefert die ganze Liste mit allen Werten statt der schlanken Übersicht.

get_corporate_language

Sprachleitfaden der Marke: Stimme mit Kapiteln (Ansprache, Wortwahl, Satzbau, Do/Don’t), Terminologie, Firmierung und Schreibweisen. Vor jedem Text für die Marke abrufen, etwa bei „Schreib einen Newsletter-Text“ oder „Wie sprechen wir Kundschaft an?“. Ohne Parameter kommt das ganze Dokument; mit section oder chapter gezielt nur ein Teil. Mit query (z. B. „Duzen wir oder siezen wir?“) kommen nur die passenden Kapitel der Stimme als Verweise (slug, title, snippet), den Inhalt danach per chapter holen. Das Inhaltsverzeichnis in der Antwort zeigt, was es gibt. Die Regeln beim Schreiben anwenden.

Eigenschaften: nur lesend, idempotent, nicht greift auf externe Systeme zu.

Parameter	Typ	Pflicht	Beschreibung
section	string	nein	Nur diese Sektion holen: meta, voice, terminology, company_name, notation. Ohne Angabe kommt das ganze Dokument. Erlaubte Werte: meta, voice, terminology, company_name, notation.
chapter	string	nein	Nur dieses Kapitel der Stimme holen, per Slug aus dem Inhaltsverzeichnis, z. B. „personal-address“.
query	string	nein	Frage oder Stichworte, z. B. „Duzen wir oder siezen wir?“ (höchstens 300 Zeichen). Liefert die passenden Kapitel der Stimme als Verweise in matches; den Inhalt danach mit chapter holen. Gilt nicht zusammen mit section.
limit	integer	nein	Anzahl Kapitel bei query, Standard 5, höchstens 10.

get_media

Veraltet, stattdessen search_media nehmen. Listet die freigegebenen Bilder der Marke ohne Filter (neueste zuerst) in derselben Trefferform wie search_media.

Eigenschaften: nur lesend, idempotent, nicht greift auf externe Systeme zu.

Parameter	Typ	Pflicht	Beschreibung
cursor	string	nein	next_cursor aus der vorigen Antwort, um weiterzublättern.

search_media

Sucht freigegebene Bilder der Marke nach Stichworten und Filtern (Kategorie, Tags, Verwendungszweck, Format, Herkunft, KI). Nutzen, wenn ein Bild für einen Beitrag gesucht wird, z. B. „Teamfoto im Büro, Querformat“. Mit Modul „Markenagent (KI)“ findet query auch nach Bedeutung der Bildbeschreibung (z. B. „Menschen bei der Arbeit“ trifft „Kolleginnen am Schreibtisch“), die Filter gelten weiter. Treffer sind Verweise mit Titel, Rechte-Status und Link in die Media-Galerie; Details und Downloads mit get_media_item; die id eines Treffers taugt als media_item_id für append_block. Lizenzablauf und KI-Kennzeichnung mitnennen; Bilder mit locked: true nur mit dem Hinweis vorschlagen, die Freigabe beim Marketing anzufragen.

Eigenschaften: nur lesend, idempotent, nicht greift auf externe Systeme zu.

Parameter	Typ	Pflicht	Beschreibung
query	string	nein	Freitext, z. B. „Teamfoto Büro“. Durchsucht Titel, Beschreibung, Tags, Kategorie, Personen und Verwendungszwecke, mit Modul „Markenagent (KI)“ auch nach Bedeutung (z. B. „Menschen bei der Arbeit“).
category	string	nein	Name der Kategorie, z. B. „Menschen“.
tags	array<string>	nein	Namen von Tags; alle müssen zutreffen.
usage	string	nein	Name des Verwendungszwecks, z. B. „Social Media“.
orientation	string	nein	Bildformat: landscape (quer), portrait (hoch) oder square (quadratisch). Erlaubte Werte: landscape, portrait, square.
source	string	nein	Herkunft: own (Eigenproduktion) oder stock. Erlaubte Werte: own, stock.
ai_generated	boolean	nein	true nur KI-Bilder, false nur Bilder ohne KI.
limit	integer	nein	Anzahl Treffer, Standard 10, höchstens 30.
cursor	string	nein	next_cursor aus der vorigen Antwort, um weiterzublättern.

get_media_item

Liefert alle Angaben zu einem freigegebenen Bild: Rechte (Urheber, Copyright, Lizenz, Ablauf, Stock-Quelle), abgebildete Personen, KI-Kennzeichnung, Maße, Verwendungszwecke, mögliche Zuschnittformate und Download-Links. Nutzen, wenn ein Treffer aus search_media geprüft oder heruntergeladen werden soll, z. B. „Darf ich dieses Bild für Social Media nutzen?“. Die Links führen ins Portal und verlangen dort einen Login; sie sind keine Direktlinks auf die Datei. Gesperrte Bilder kommen ohne Links, Freigabe beim Marketing anfragen.

Eigenschaften: nur lesend, idempotent, nicht greift auf externe Systeme zu.

Parameter	Typ	Pflicht	Beschreibung
id	string	ja	ID des Bildes, wie in den Treffern von search_media.

search_pages

Sucht in den Guideline-Seiten des Portals, etwa nach „Schutzzone Logo“ oder „Wie setzen wir Bilder ein?“. Findet per Volltext und mit Modul „Markenagent (KI)“ auch nach Bedeutung. Treffer sind Verweise (id, title, url, snippet): den Inhalt danach mit get_page lesen und die url als Quelle nennen. Ohne query kommen alle Seiten als Liste.

Eigenschaften: nur lesend, idempotent, nicht greift auf externe Systeme zu.

Parameter	Typ	Pflicht	Beschreibung
query	string	nein	Suchbegriffe oder eine Frage, z. B. „Schutzzone Logo“ (höchstens 300 Zeichen). Leer: alle Seiten.
limit	integer	nein	Anzahl Treffer bei einer Suche, Standard 5, höchstens 10.

search_website

Sucht in der eingelesenen Website der Marke nach Produkten, Angeboten, News und Unternehmensseiten, z. B. „Welche Konditionen hat das Girokonto?“. Die Frage als Satz oder in Stichworten stellen. Treffer: title, url, heading, snippet. Die url als Quelle nennen; für Markenregeln stattdessen search_pages nehmen.

Eigenschaften: nur lesend, idempotent, nicht greift auf externe Systeme zu.

Parameter	Typ	Pflicht	Beschreibung
query	string	ja	Suchanfrage, z. B. „Welche Konditionen hat das Girokonto?“ (höchstens 300 Zeichen).
limit	integer	nein	Anzahl Treffer, Standard 5, höchstens 10.

get_page

Liest eine Portalseite vollständig, mit allen Blöcken und ihren stabilen IDs. Nach search_pages aufrufen, um eine Regel nachzulesen und mit Link zu belegen, oder vor append_block und update_block, um die Block-ID zu finden.

Eigenschaften: nur lesend, idempotent, nicht greift auf externe Systeme zu.

Parameter	Typ	Pflicht	Beschreibung
page_id	integer	ja	ID der Seite (aus search_pages).

create_page

Legt eine neue Portalseite an. Die Seite ist sofort live, jede Änderung wird versioniert und lässt sich im Backend zurücksetzen. Nur auf ausdrücklichen Wunsch nutzen. Start-Blöcke folgen denselben Regeln wie bei append_block.

Eigenschaften: nicht destruktiv, nicht greift auf externe Systeme zu.

Parameter	Typ	Pflicht	Beschreibung
title	string	ja	Titel der neuen Seite.
type	string	nein	Optional: guideline (Standard, Inhaltsseite) oder container (Navigationskapitel ohne Inhalt).
parent_id	integer	nein	Optional: ID eines Container-Kapitels, dem die Seite untergeordnet wird. Nur Container können Eltern sein; Container selbst haben keinen Parent.
nav_expansion	string	nein	Nur für Container: collapsible (startet geschlossen) oder pinned_open (Kinder immer sichtbar). Standard collapsible.
blocks	array	nein	Optionale Start-Blöcke, je {type, data} — siehe append_block für die schreibbaren Typen. Medien-/Asset-IDs müssen zur Marke des Tokens gehören. Bei Containern ignoriert.

append_block

Hängt einen Block ans Ende einer Seite, sofort live und versioniert. Nur auf ausdrücklichen Wunsch nutzen. Schreibbare Typen: heading, rich_text, alert, button, video, image_placeholder, accordion, table, columns, group, image, gallery, tabs, asset_download, download_list, color_palette. Medien- und Datei-Blöcke brauchen eine media_item_id bzw. asset_id der eigenen Marke: die id eines Treffers aus search_media bzw. search_downloads direkt einsetzen. Fremde oder erfundene IDs lehnt der Server ab.

Eigenschaften: nicht destruktiv, nicht greift auf externe Systeme zu.

Parameter	Typ	Pflicht	Beschreibung
page_id	integer	ja	ID der Zielseite.
type	string	ja	Block-Typ: heading, rich_text, alert, button, video, image_placeholder, accordion, table, columns, group, image, gallery, tabs, asset_download, download_list oder color_palette.
data	object	ja	Block-Felder, z. B. {“text”:“…”}, {“body”:“<p>…</p>”} oder {“variant”:“warning”,“title”:“…”,“body”:“…”}. Medien-/Asset-Blöcke: {“media_item_id”:“<id aus search_media>”,“aspect”:“1:1”} bzw. {“asset_id”:“<id aus search_downloads>”}; die ID muss zur Marke des Tokens gehören.

update_block

Ändert einen einzelnen Block über seine ID aus get_page. Nur die gesendeten Felder ändern sich, der Rest bleibt. Sofort live und versioniert, nur auf ausdrücklichen Wunsch nutzen.

Eigenschaften: destruktiv, idempotent, nicht greift auf externe Systeme zu.

Parameter	Typ	Pflicht	Beschreibung
page_id	integer	ja	ID der Seite.
block_id	string	ja	Stabile ID des Blocks (aus get_page).
data	object	ja	Zu ändernde Felder, z. B. {“text”:“Neuer Text”}. Bei Medien-/Asset-Blöcken muss eine neue media_item_id/asset_id zur Marke des Tokens gehören.

search_downloads

Sucht Download-Dateien der Marke: Logos, Vorlagen, Schriften, Dokumente. Nutzen, wenn jemand eine Datei braucht, z. B. „Wo finde ich das Logo als SVG?“. Mit query nach Titel und Dateiname, mit kind nach Dateityp filtern, ohne beides kommt eine Liste der Dateien. Je Treffer id, title, filename, format, visibility und portal_url; die id taugt als asset_id für append_block. Die portal_url weitergeben, nie die Datei selbst; sie öffnet den Download im Portal, bei visibility „login“ nach der Anmeldung.

Eigenschaften: nur lesend, idempotent, nicht greift auf externe Systeme zu.

Parameter	Typ	Pflicht	Beschreibung
query	string	nein	Optional: Suchbegriffe in Titel und Dateiname, z. B. „Logo“ oder „PowerPoint Vorlage“.
kind	string	nein	Optional: nur Dateien dieses Typs (logo, template, font, document), erkannt an Dateiendung und Titel. Erlaubte Werte: logo, template, font, document.

get_brand_context

Liest den geprüften Markenkontext: Positionierung, Zielgruppen, Angebot, Wettbewerb, Kernbotschaften, Geschichte und Fakten, häufige Fragen. Nutzen für Hintergrund- und Strategiefragen, z. B. „Wer sind die Zielgruppen der Marke?“. Mit category kommt nur diese Kategorie, mit query nur die zur Frage passenden Einträge (findet auch Umschreibungen, z. B. query „Wer kauft bei uns?“ liefert die Zielgruppen), ohne beides alle Einträge. Jede Antwort enthält contents (Kategorien mit Anzahl Einträgen), damit sich gezielt nachladen lässt. Je Eintrag gibt es Titel, Text und Beleg; die Texte sind geprüfte Aussagen zur Marke und dürfen so verwendet werden.

Eigenschaften: nur lesend, idempotent, nicht greift auf externe Systeme zu.

Parameter	Typ	Pflicht	Beschreibung
category	string	nein	Optional: nur diese Kategorie lesen. Ohne Angabe kommen alle Einträge. Erlaubte Werte: positioning, audiences, offering, competition, messages, history, faq, other.
query	string	nein	Optional: Frage oder Stichworte, z. B. „Wer sind unsere Zielgruppen?“ (höchstens 300 Zeichen). Liefert nur die passenden Einträge, per Volltext und nach Bedeutung. Zusammen mit category sucht es nur in dieser Kategorie.
limit	integer	nein	Anzahl Treffer bei query, Standard 5, höchstens 10.

check_terms

Prüft einen Text gegen die Wortregeln der Marke: verbotene Begriffe, bevorzugte Begriffe und die richtige Schreibweise des Unternehmensnamens. Nutzen, bevor ein Text für die Marke fertig ist, z. B. „Entspricht dieser Newsletter unserer Terminologie?“. Ergebnis: findings mit Fundstelle (Zeile, Position), Ersatzvorschlag und Begründung. Die Funde im Text ersetzen und danach erneut prüfen. Das Tool prüft nur Wortlisten, nicht Ton oder Stil; dafür get_corporate_language nehmen.

Eigenschaften: nur lesend, idempotent, nicht greift auf externe Systeme zu.

Parameter	Typ	Pflicht	Beschreibung
text	string	ja	Der zu prüfende Text (höchstens 20000 Zeichen).

Resources

brandhub://corporate-language

Sprachleitfaden der Marke als ganzes Dokument: Stimme mit Kapiteln, Terminologie, Firmierung und Schreibweisen, samt Version. Vor jedem Text lesen, der für die Marke entsteht, und beim Schreiben anwenden. Für einzelne Abschnitte oder Kapitel das Tool get_corporate_language nehmen.

Feld	Wert
Titel	Corporate Language
MIME-Typ	application/json

brandhub://brand-context

Geprüftes Wissen über die Marke: Positionierung, Zielgruppen, Angebot, Wettbewerb, Kernbotschaften, Fakten und häufige Fragen, je Eintrag mit Beleg. Lesen, bevor Texte oder Konzepte für die Marke entstehen. Für eine einzelne Kategorie das Tool get_brand_context nehmen.

Feld	Wert
Titel	Markenkontext
MIME-Typ	application/json