brandfound.

Command Palette

Search for a command to run...

MCP Server

Connexion du serveur MCP

Le Model Context Protocol permet aux assistants IA de travailler directement avec brandfound. — gérer des entreprises, analyser des mentions et créer du contenu depuis le chat. Chaque outil MCP est un appel HTTP vers l' API v1. Certains endpoints sont optimisés pour le workflow MCP (context_only pour la Fabrique, configuration atomique pour les requêtes).

Endpoint MCP

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

OAuth 2.1 + PKCE

Autorisation sécurisée via le navigateur. La clé API est créée automatiquement à la première connexion. Le jeton est valable 90 jours. Vous pouvez révoquer l'accès dans les paramètres.

Autorisation
ProtocoleOAuth 2.1
PKCES256
TransportHTTP
Jetons
Préfixegfx_
TTL90 jours
FormatBearer
Discovery
Protected Resource/.well-known/oauth-protected-resource
Authorization Server/.well-known/oauth-authorization-server

Choisissez un assistant IA

Cliquez sur le client souhaité — les instructions de connexion s'afficheront.

Outils disponibles

50

Une fois connecté, le connecteur expose ces fonctions brandfound. au client LLM. Le client choisit lui-même celles qui sont nécessaires selon la tâche.

Espaces de travail

2

Un jeton pour tous les espaces accessibles

  • •Un jeton OAuth a un espace actif, initialement celui de connexion. switch_workspace choisit un autre espace où votre invitation est ACCEPTED.
  • •Le changement persiste dans ApiKey.activeAccountId et s’applique dès la prochaine requête à tous les clients MCP de cette clé, dont Claude Desktop et Cursor. Sans reconnexion.
  • •Les accès sont vérifiés à CHAQUE requête. Après retrait de l’équipe, le prochain outil revient discrètement à l’espace initial du jeton, sans 401.
  • •Le changement réinitialise preferredCompanyId, lié à l’ancien espace.
  • list_workspaces

    Espaces accessibles : personnel et adhésions TeamMember ACCEPTED, avec l’espace actif indiqué

  • switch_workspace

    Changer durablement l’espace actif de la clé API ; réinitialise preferredCompanyId

    accountId

Entreprises et produits

7

v1.1 : upsert remplace les paires create/update

  • •save_company / save_competitor / save_product remplacent create_* et update_* : sans id, création ; avec id, modification des seuls champs fournis.
  • •La mise à jour de synonyms remplace toute la liste, sans fusion. Envoyez le tableau complet pour l’enrichir.
  • list_companies

    Entreprises de l’utilisateur avec recherche et pagination

    search, limit, offset, sortBy, sortOrder

  • get_company

    Détails d’une entreprise et de ses produits

    companyId

  • save_company

    Créer ou modifier une entreprise ; sans companyId, création. regionTargets définit les pays de mesure et de génération des requêtes.

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

  • get_company_categories

    Répertoire des catégories d’entreprise : secteurs et niches

  • search_geo

    Pays, villes et langues avec leurs UUID pour regionTargets et defaultLanguageId

    kind, q, countryIso2, limit

  • save_competitor

    Créer ou modifier un concurrent ; sans competitorId, création

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

  • save_product

    Créer ou modifier un produit, y compris réattribuer les intents (upsert)

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

Mots-clés

3

v1.1 : cycle de vie via action

  • •manage_keyword regroupe create / rename / archive / restore / delete via action. archive et delete prennent en charge dryRun.
  • •link_keywords regroupe attach par nom (find-or-create) et detach par keywordIds pour les liens company / product / competitor.
  • list_keywords

    Mots-clés filtrés par target et état

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

  • manage_keyword

    Gérer un mot-clé : create / rename / archive / restore / delete

    action, keywordId, name, attach, dryRun

  • link_keywords

    Associer des mots-clés par nom ou les dissocier par id d’un target, en lot

    action, target, names, keywordIds

Analytique et métriques

9

v1.1 : rapports regroupés

  • •get_analytics_report remplace six outils par un sélecteur report : overview / keywords / timeline / recent / geo / cluster.
  • •get_trends regroupe sujets stratégiques (scope="topics",7–30 jours) et signaux tactiques (scope="pulse",6–72 heures).
  • get_competitor_analytics

    Analyse concurrentielle : Share of Voice et leaders

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

  • get_brand_visibility

    Évolution du Brand Mention Rate (BMR) : visibilité de marque

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

  • get_tonality

    Analyse de sentiment : sentiment, fairness, helpfulness et plus de 10 indicateurs

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

  • list_mentions

    Mentions de marque dans les réponses IA avec filtres

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

  • list_queries

    Requêtes IA avec réponses et analyse

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

  • get_trends

    Tendances : scope="topics" (stratégie,7–30 jours) ou scope="pulse" (signaux,6–72 heures)

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

  • get_analytics_report

    Rapport de synthèse : overview / keywords / timeline / recent / geo / cluster

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

  • list_query_labels

    Étiquettes et clusters de requêtes avec leurs volumes

    companyId, q, limit, offset, lite

  • list_notifications

    Notifications utilisateur (WIDGET / BANNER / TOAST / EMAIL)

    limit, offset, type, includeDismissed

Requêtes

7

Deux options : votre agent écrit les requêtes ou le service les génère

  • •setup_queries utilise BYO-LLM : votre agent écrit les requêtes depuis la fiche de marque (get_brand_card) et les concurrents (get_company). Gratuit, hors tokens de votre propre LLM.
  • •autogenerate_queries crée des BROUILLONS à 1 FoxCoin par requête, sans interroger les IA. approve_query_drafts lance la collecte payante à 10 FoxCoin par réponse (requête×modèle). Lancez dryRun et montrez le devis avant validation.
  • •Six types : neutral, commercial, informational (sans marque), comparative (marque+concurrent en base), reputational et branded (marque dans le texte). Les alias historiques negative/general sont acceptés.
  • •La génération utilise les régions de l’entreprise (save_company.regionTargets). Pour plusieurs pays, transmettez targets : une tâche par pays, langue officielle par défaut (AE→ar,IN→hi).
  • •list_answers exporte jusqu’à 200 réponses par appel avec liens et mentions, sans boucler sur chaque requête.
  • setup_queries

    Créer les requêtes de votre agent avec clusters et collecte IA payante facultative

    companyId, clusters, providers

  • autogenerate_queries

    Générer des brouillons sans interroger les IA (1 FoxCoin par requête)

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

  • get_autogeneration_status

    Progression de génération : RUNNING / OK / FAILED / CANCELLED

    clientToken, runId, limit

  • list_query_drafts

    Requêtes générées en attente de validation

    status, companyId, type, page, limit

  • approve_query_drafts

    Valider les brouillons et lancer la collecte payante des modèles sélectionnés ; dryRun estime seulement les coûts

    draftIds, providers, dryRun

  • reject_query_drafts

    Rejeter gratuitement les brouillons, sans collecte IA

    draftIds

  • list_answers

    Réponses IA par lot : liens, mentions, brandDomainCited

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

Factory

13

v1.1 : BYO-LLM par défaut ; seul mode="generate" explicite est payant

  • •enrich_content_task / generate_content_plan / generate_article utilisent mode="context_only" par défaut et renvoient prompt et contexte. Le LLM du client rédige et sauvegarde via save_*, sans débit FoxCoin.
  • •mode="generate" explicite lance la génération serveur payante comme dans l’interface : enrichissement 20 FC, plan 50 FC, article 70 FC ; solde insuffisant 402 INSUFFICIENT_FOXCOINS.
  • •suggest_topics a été supprimé. L’agent propose des angles depuis le contexte enrichi et transmet topicTitle à generate_content_plan.
  • •manage_content_task regroupe create / update / archive des tâches kanban via action.
  • list_content_tasks

    Tâches kanban de la fabrique avec filtres

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

  • get_content_task

    Tâche complète, avec son article enregistré

    id

  • manage_content_task

    Créer / modifier / archiver une tâche via action

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

  • enrich_content_task

    Enrichir une tâche : recherche RAG, analyse et concurrents (context_only gratuit ; generate 20 FC)

    taskId, companyId, topic, description, keywords, mode

  • generate_content_plan

    Plan d’article : structure, idées clés et tone (context_only gratuit ; generate 50 FC)

    taskId, prompt, topicId, topicTitle, mode

  • generate_article

    Article intégral en Markdown (context_only gratuit ; generate 70 FC)

    taskId, planId, articleLength, mode

  • save_enrichment_analysis

    Enregistrer l’analyse du LLM client

    taskId, aiAnalysis, usage

  • save_generated_plan

    Enregistrer le plan JSON du LLM client

    taskId, plan, topicId, topicTitle, prompt, usage

  • save_generated_article

    Enregistrer l’article Markdown du LLM client

    taskId, content, planId, usage

  • set_publication_url

    Définir l’URL publiée pour suivre le BMR

    taskId, publishedUrl

  • detect_insights

    Détecter 15 types d’insights : lacunes de contenu, succès concurrents ; gratuit, par règles

    companyId, insightType

  • list_content_tags

    Étiquettes de la fabrique avec nombre de tâches

  • list_publications

    Contenus publiés et indicateurs de performance

    companyId

Carte de marque

5

Votre agent peut lire et gérer toute la fiche de marque

  • •La fiche de marque est une arborescence Markdown : instruction.md est envoyé en premier ; main / settings.md s’applique toujours, avec vos fichiers produits, faits, cas et FAQ.
  • •Les fichiers se lient avec [Nom](brandcard://<id>), ID dans l’index. Les liens survivent au renommage et priorisent les fichiers liés. Limite d’injection : environ 60000 caractères.
  • •Les blocs ```private sont retirés automatiquement avant envoi à l’IA. save_brand_card_file remplace le fichier entier : lisez-le avant modification.
  • •Parcours conseillé : get_brand_card_index (structure+liens) → get_brand_card_file aux chemins utiles → save_brand_card_file. Prompt MCP manage-brand-card : fill / audit / restructure.
  • get_brand_card

    Fiche entière en Markdown : manifeste → core → fichiers liés → autres ; blocs privés retirés

    companyId

  • get_brand_card_index

    Index : manifeste et fichiers avec path, id, isCore et liens sortants

    companyId

  • get_brand_card_file

    Un fichier par chemin : content conserve les liens brandcard:// ; links les résout en chemins

    companyId, path

  • save_brand_card_file

    Créer ou remplacer un fichier par chemin ; dossiers manquants créés automatiquement

    companyId, path, content

  • delete_brand_card_file

    Supprimer un fichier ou dossier récursivement ; les fichiers structurels sont protégés

    companyId, path