brandfound.

Command Palette

Search for a command to run...

MCP Server

Verbindung des MCP-Servers

Das Model Context Protocol ermöglicht es KI-Assistenten, direkt mit brandfound. zu arbeiten — Unternehmen verwalten, Erwähnungen analysieren und Inhalte aus dem Chat erstellen. Jedes MCP-Tool ist ein HTTP-Aufruf der API v1. Einige Endpoints sind für den MCP-Workflow optimiert (context_only für die Factory, atomares Setup für Anfragen).

MCP-Endpoint

https://app.brandfound.ai/api/mcp/stream

OAuth 2.1 + PKCE

Sichere browserbasierte Autorisierung. Der API-Schlüssel wird beim ersten Verbinden automatisch erstellt. Das Token ist 90 Tage gültig. Sie können den Zugriff in den Einstellungen widerrufen.

Autorisierung
ProtokollOAuth 2.1
PKCES256
TransportHTTP
Tokens
Präfixgfx_
TTL90 Tage
FormatBearer
Discovery
Protected Resource/.well-known/oauth-protected-resource
Authorization Server/.well-known/oauth-authorization-server

Wählen Sie einen KI-Assistenten

Klicken Sie auf den gewünschten Client — die Verbindungsanleitung wird angezeigt.

Verfügbare Tools

50

Nach der Verbindung stellt der Connector dem LLM-Client diese brandfound.-Funktionen zur Verfügung. Der Client wählt je nach Aufgabe die passenden aus.

Arbeitsbereiche

2

Ein Token für alle zugänglichen Arbeitsbereiche

  • •Ein OAuth-Token hat einen aktiven Arbeitsbereich, zunächst den der Anmeldung. switch_workspace wählt einen anderen mit einer ACCEPTED-Einladung.
  • •Der Wechsel bleibt in ApiKey.activeAccountId gespeichert und gilt ab der nächsten Anfrage für alle MCP-Clients dieses Schlüssels, auch Claude Desktop und Cursor. Keine erneute Anmeldung nötig.
  • •Der Zugriff wird bei JEDER Anfrage geprüft. Nach Entfernen aus dem Team kehrt der nächste Tool-Aufruf ohne 401 zum ursprünglichen Arbeitsbereich zurück.
  • •Der Wechsel setzt auch preferredCompanyId zurück, da es zum vorherigen Arbeitsbereich gehört.
  • list_workspaces

    Zugängliche Arbeitsbereiche: eigener und ACCEPTED TeamMember, mit Markierung des aktiven Bereichs

  • switch_workspace

    Aktiven Arbeitsbereich des API-Schlüssels dauerhaft wechseln; setzt preferredCompanyId zurück

    accountId

Unternehmen & Produkte

7

v1.1: upsert ersetzt create/update-Paare

  • •save_company / save_competitor / save_product ersetzen create_* und update_*: ohne id erstellen, mit id nur übergebene Felder ändern.
  • •synonyms ersetzt beim Aktualisieren die gesamte Liste, ohne Zusammenführen. Bei Ergänzungen das vollständige Array senden.
  • list_companies

    Unternehmen des Benutzers mit Suche und Paginierung

    search, limit, offset, sortBy, sortOrder

  • get_company

    Details zu einem Unternehmen und seinen Produkten abrufen

    companyId

  • save_company

    Unternehmen erstellen oder ändern; ohne companyId neu anlegen. regionTargets legt Messländer und das Land der Anfragegenerierung fest.

    companyId?, name, description, url, country, categoryId, synonyms, regionTargets, defaultLanguageId, defaultResponseLanguageId, defaultLocale, autogenQueryTypes, autogenQueriesPerRun

  • get_company_categories

    Verzeichnis der Unternehmenskategorien: Branchen und Nischen

  • search_geo

    Länder, Städte und Sprachen mit UUIDs für regionTargets und defaultLanguageId

    kind, q, countryIso2, limit

  • save_competitor

    Wettbewerber erstellen oder ändern; ohne competitorId neu anlegen

    competitorId?, companyId, name, productId, url, synonyms

  • save_product

    Produkt erstellen oder ändern, einschließlich Neuzuordnung von intents (upsert)

    productId?, companyId, name, description, url, intents

Schlüsselwörter

3

v1.1: Lebenszyklus über action

  • •manage_keyword vereint create / rename / archive / restore / delete über action. archive und delete unterstützen dryRun.
  • •link_keywords vereint attach nach Namen (find-or-create) und detach nach keywordIds für company / product / competitor.
  • list_keywords

    Schlüsselwörter nach target und Status filtern

    companyId, productId, competitorId, state, search, limit, offset, sortBy, sortOrder

  • manage_keyword

    Ein Schlüsselwort verwalten: create / rename / archive / restore / delete

    action, keywordId, name, attach, dryRun

  • link_keywords

    Schlüsselwörter gesammelt nach Namen zuordnen oder nach id von target lösen

    action, target, names, keywordIds

Analytik & Metriken

9

v1.1: Zusammengefasste Berichte

  • •get_analytics_report ersetzt sechs Tools durch den Selektor report: overview / keywords / timeline / recent / geo / cluster.
  • •get_trends vereint strategische Themen (scope="topics",7–30 Tage) und taktische Signale (scope="pulse",6–72 Stunden).
  • get_competitor_analytics

    Wettbewerbsanalyse: Share of Voice und Marktführer

    companyId, productId, timeRange, dateFrom, dateTo, sourceIds, labelSlugs, labelFilterMode

  • get_brand_visibility

    Brand Mention Rate (BMR) im Zeitverlauf: Markensichtbarkeit

    companyId, productId, timeRange, granularity, dateFrom, dateTo, sourceIds, labelSlugs, labelFilterMode

  • get_tonality

    Tonalitätsanalyse: sentiment, fairness, helpfulness und über 10 Kennzahlen

    companyId, productId, timeRange, dateFrom, dateTo, sourceIds, labelSlugs, labelFilterMode, queryType, sentiment

  • list_mentions

    Markenerwähnungen in KI-Antworten mit Filtern

    companyId, productId, competitorId, sourceIds, timeRange, dateFrom, dateTo, sentiment, type, isOurs, search, sortBy, sortOrder, limit, offset

  • list_queries

    KI-Anfragen mit Antworten und Analyse

    companyId, productId, hasAnswers, searchText, sourceIds, types, sentiment, dateFrom, dateTo, isFavorite, sortBy, sortOrder, limit, offset

  • get_trends

    Trends: scope="topics" (Strategie,7–30 Tage) oder scope="pulse" (Signale,6–72 Stunden)

    scope, companyId, timeRange, limit, minGrowthPercent, window, signals, minSeverity

  • get_analytics_report

    Zusammenfassung: overview / keywords / timeline / recent / geo / cluster

    report, companyId, timeRange, productId, category, granularity, groupBy, labelId

  • list_query_labels

    Anfrage-Labels und Cluster mit Anzahl der Anfragen

    companyId, q, limit, offset, lite

  • list_notifications

    Benutzerbenachrichtigungen (WIDGET / BANNER / TOAST / EMAIL)

    limit, offset, type, includeDismissed

Anfragen

7

Zwei Wege: Ihr Agent schreibt Anfragen oder der Dienst generiert sie

  • •setup_queries nutzt BYO-LLM: Ihr Agent schreibt Anfragen anhand der Markenkarte (get_brand_card) und Wettbewerber (get_company). Kostenlos, nur die Tokens Ihrer LLM werden bezahlt.
  • •autogenerate_queries erstellt ENTWÜRFE für 1 FoxCoin je Anfrage, ohne KI-Abfrage. approve_query_drafts startet kostenpflichtige Abfragen:10 FoxCoin je Antwort (Anfrage×Modell). Vor Bestätigung dryRun ausführen und Kosten zeigen.
  • •Sechs Typen: neutral, commercial, informational (ohne Marken), comparative (Marke+Wettbewerber aus Datenbank), reputational und branded (Marke im Text). Legacy-Aliase negative/general werden akzeptiert.
  • •Die Generierung nutzt die Regionseinstellungen (save_company.regionTargets). Für mehrere Länder targets übergeben: eine Aufgabe je Land, Standardsprache ist die Amtssprache (AE→ar,IN→hi).
  • •list_answers exportiert bis zu 200 Antworten je Aufruf mit Links und Erwähnungen statt Einzelschleifen je Anfrage.
  • setup_queries

    Vom Agenten geschriebene Anfragen mit Clustern und optional kostenpflichtiger KI-Abfrage erstellen

    companyId, clusters, providers

  • autogenerate_queries

    Anfrageentwürfe ohne KI-Abfrage generieren (1 FoxCoin je Anfrage)

    companyId, productId, count, types, clusters, userWishes, name, region, language, city, includeDistricts, targets

  • get_autogeneration_status

    Fortschritt der Generierung: RUNNING / OK / FAILED / CANCELLED

    clientToken, runId, limit

  • list_query_drafts

    Generierte Anfragen zur Bestätigung

    status, companyId, type, page, limit

  • approve_query_drafts

    Entwürfe bestätigen und kostenpflichtige Abfrage gewählter Modelle starten; dryRun zeigt nur Kosten

    draftIds, providers, dryRun

  • reject_query_drafts

    Entwürfe kostenlos ablehnen, ohne KI-Abfrage

    draftIds

  • list_answers

    KI-Antworten gesammelt: Links, Erwähnungen, brandDomainCited

    companyId, productId, queryId, provider, type, label, region, language, createdAtFrom, createdAtTo, hasLinks, mentionsOurs, include, limit, offset

Factory

13

v1.1: BYO-LLM als Standard; nur explizites mode="generate" kostet

  • •enrich_content_task / generate_content_plan / generate_article nutzen standardmäßig mode="context_only" und liefern Prompt und Kontext. Die Client-LLM schreibt und speichert über save_*; keine FoxCoin-Kosten.
  • •Explizites mode="generate" startet kostenpflichtige Servergenerierung wie im UI: Anreicherung 20 FC, Plan 50 FC, Artikel 70 FC; bei Geldmangel 402 INSUFFICIENT_FOXCOINS.
  • •suggest_topics wurde entfernt. Der Agent entwickelt alternative Ansätze aus dem Anreicherungskontext und übergibt topicTitle an generate_content_plan.
  • •manage_content_task vereint create / update / archive von Kanban-Aufgaben über action.
  • list_content_tasks

    Factory-Kanban-Aufgaben mit Filtern

    companyId, statuses, types, priorities, search, tagId, aiGenerated, sortBy, sortOrder, limit, offset

  • get_content_task

    Vollständige Aufgabe mit gespeichertem Artikel

    id

  • manage_content_task

    Factory-Aufgabe über action erstellen / ändern / archivieren

    action, taskId, title, companyId, type, status, priority, description, targetKeywords

  • enrich_content_task

    Aufgabe anreichern: RAG-Suche, Analyse und Wettbewerber (context_only kostenlos; generate 20 FC)

    taskId, companyId, topic, description, keywords, mode

  • generate_content_plan

    Artikelplan: Struktur, Thesen und tone (context_only kostenlos; generate 50 FC)

    taskId, prompt, topicId, topicTitle, mode

  • generate_article

    Vollständiger Markdown-Artikel (context_only kostenlos; generate 70 FC)

    taskId, planId, articleLength, mode

  • save_enrichment_analysis

    Analyse der Client-LLM speichern

    taskId, aiAnalysis, usage

  • save_generated_plan

    JSON-Content-Plan der Client-LLM speichern

    taskId, plan, topicId, topicTitle, prompt, usage

  • save_generated_article

    Markdown-Artikel der Client-LLM speichern

    taskId, content, planId, usage

  • set_publication_url

    URL des veröffentlichten Artikels für BMR-Tracking setzen

    taskId, publishedUrl

  • detect_insights

    15 Erkenntnistypen erkennen: Content-Lücken, Wettbewerbererfolge; kostenlos, regelbasiert

    companyId, insightType

  • list_content_tags

    Factory-Tags mit Aufgabenanzahl

  • list_publications

    Veröffentlichte Inhalte mit Erfolgskennzahlen

    companyId

Markenkarte

5

Ihr Agent kann die gesamte Markenkarte lesen und verwalten

  • •Die Markenkarte ist ein Markdown-Baum: instruction.md geht zuerst an die KI; main / settings.md gilt immer. Dazu kommen Benutzerdateien und Ordner für Produkte, Fakten, Fälle und FAQ.
  • •Dateien verweisen über [Name](brandcard://<id>), IDs stehen im Index. Links überstehen Umbenennungen; verknüpfte Dateien werden priorisiert. One-Shot-Limit: etwa 60.000 Zeichen.
  • •```private-Blöcke werden vor KI-Nutzung automatisch entfernt. save_brand_card_file überschreibt die ganze Datei; deshalb vor Änderungen immer lesen.
  • •Empfohlener Ablauf: get_brand_card_index (Struktur+Links) → get_brand_card_file für benötigte Pfade → save_brand_card_file. MCP-Prompt manage-brand-card: fill / audit / restructure.
  • get_brand_card

    Gesamte Karte als Markdown: Manifest → Core → verknüpfte → übrige Dateien; private Blöcke entfernt

    companyId

  • get_brand_card_index

    Kartenindex: Manifest und Dateien mit path, id, isCore und ausgehenden Links

    companyId

  • get_brand_card_file

    Datei nach Pfad: content erhält brandcard://-Links wortgetreu; links löst sie zu Pfaden auf

    companyId, path

  • save_brand_card_file

    Datei nach Pfad erstellen oder überschreiben; fehlende Ordner werden automatisch angelegt

    companyId, path, content

  • delete_brand_card_file

    Datei oder Ordner rekursiv löschen; geschützte Grunddateien bleiben erhalten

    companyId, path