56 tools

Command Palette

Search for a command to run...

MCP Server

Connecting the MCP server

Model Context Protocol lets AI assistants work with brandfound. directly — manage companies, analyse mentions, and create content from chat. Each MCP tool is an HTTP call to API v1. Some endpoints are optimized for the MCP workflow (context_only for the Factory, atomic setup for queries).

MCP Endpoint

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

OAuth 2.1 + PKCE

Secure browser-based authorization. The API key is created automatically on first connection. The token is valid for 90 days. You can revoke access in the settings.

Authorization
ProtocolOAuth 2.1
PKCES256
TransportHTTP
Tokens
Prefixgfx_
TTL90 days
FormatBearer
Discovery
Protected Resource/.well-known/oauth-protected-resource
Authorization Server/.well-known/oauth-authorization-server

Choose an AI assistant

Click the client you need — connection instructions will appear.

Available tools

56

Once connected, the connector exposes these brandfound. functions to the LLM client. The client picks the right ones depending on the task.

Окружения (workspaces)

2

Один токен — все доступные окружения

  • •У одного OAuth-токена есть «активное» окружение. По умолчанию — то, в котором ты авторизовался; switch_workspace меняет его на любое другое, где у тебя ACCEPTED-инвайт.
  • •Переключение персистентно: хранится в ApiKey.activeAccountId и видно всем MCP-клиентам этого ключа (Claude Desktop, Cursor и т.п.) на следующем запросе. Переавторизация не нужна.
  • •Доступ проверяется на КАЖДОМ запросе. Если тебя удалили из команды — следующий tool молча вернётся к токеновскому окружению, без 401.
  • •Побочный эффект switch: preferredCompanyId сбрасывается, т.к. он привязан к старому окружению.
  • list_workspaces

    Список доступных окружений (свой + ACCEPTED TeamMember) с пометкой текущего

  • switch_workspace

    Переключить активное окружение для API key (персистентно); preferredCompanyId сбрасывается

    accountId

Компании и продукты

9
  • list_companies

    Список компаний пользователя с поиском и пагинацией

    search, limit, offset, sortBy, sortOrder

  • get_company

    Получить детальную информацию о компании и её продуктах

    companyId

  • create_company

    Создать новую компанию для отслеживания

    name, description, url, country, categoryId, synonyms

  • update_company

    Обновить поля существующей компании

    companyId, name, description, url, country, categoryId, synonyms, isAutoGenerationEnabled

  • get_company_categories

    Справочник категорий компаний (отраслей/ниш)

  • create_competitor

    Создать нового конкурента для отслеживания

    name, companyId, productId, url, synonyms

  • update_competitor

    Обновить данные существующего конкурента

    competitorId, name, url, synonyms

  • create_product

    Создать новый продукт внутри существующей компании

    companyId, name, description, url, intents

  • update_product

    Обновить существующий продукт или переназначить intents

    productId, name, description, url, intents

Интенты (keywords)

8
  • list_keywords

    Список интентов (keywords) с фильтрами по target и состоянию

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

  • create_keyword

    Создать или переиспользовать интент + опциональный attach к target

    name, attach

  • update_keyword

    Переименовать интент (единственное редактируемое поле)

    keywordId, name

  • archive_keyword

    Архивировать интент глобально вместе со всеми связями (обратимо)

    keywordId, dryRun

  • delete_keyword

    Полное удаление из БД — требует предварительного archive_keyword

    keywordId, dryRun

  • restore_keyword

    Восстановить интент из архива вместе со связями к живым target

    keywordId

  • attach_keywords

    Bulk-привязка имён интентов к target (find-or-create по name)

    target, names

  • detach_keywords

    Bulk-отвязка интентов от target — сам интент остаётся жить

    target, keywordIds

Аналитика и метрики

15
  • get_competitor_analytics

    Конкурентный анализ: share-of-voice и лидеры

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

  • get_brand_visibility

    Brand Mention Rate (BMR) timeline — видимость бренда

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

  • get_tonality

    Анализ тональности: sentiment, fairness, helpfulness и 10+ метрик

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

  • list_mentions

    Упоминания бренда в ответах AI-ассистентов с фильтрами

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

  • list_queries

    Список запросов к AI с ответами и аналитикой

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

  • get_trending_topics

    Стратегические трендовые темы (7–30 дней) с растущей динамикой

    companyId, timeRange, limit, minGrowthPercent

  • get_trend_pulse

    Тактический пульс трендов (6–72 часа) с event-сигналами

    companyId, window, signals, minSeverity

  • get_analytics_overview

    Дашборд-сводка по компании для быстрого обзора

    companyId, timeRange, productId

  • list_analytics_keywords

    Облако ключевых слов с частотами и категориями

    companyId, timeRange, productId, category

  • get_analytics_timeline

    Временной ряд упоминаний по дням с разбивкой

    companyId, timeRange, granularity

  • get_analytics_trending

    Лента из 10 последних упоминаний с контекстом

    companyId, timeRange, productId

  • list_query_labels

    Список меток/кластеров запросов с количеством queries

    companyId, q, limit, offset, lite

  • get_query_label_analytics

    Аналитика по кластеру: BMR, Share of Voice, Citation Rates

    id

  • list_notifications

    Уведомления пользователя (WIDGET / BANNER / TOAST / EMAIL)

    limit, offset, type, includeDismissed

  • list_geo_analytics

    Разбивка метрик по странам или регионам

    companyId, timeRange, groupBy

Запросы

2
  • setup_queries

    Создать пул запросов для мониторинга в AI-ассистентах

    companyId, clusters, providers

  • generate_queries_preview

    Получить AI-сгенерированные варианты запросов

    companyId, productId, count, queryTypes, userWishes, language, region

Фабрика

15
  • list_content_tasks

    Список задач фабрики (канбан) с фильтрами

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

  • create_content_task

    Создать новую тему в фабрике

    title, companyId, type, priority, description, targetKeywords

  • update_content_task

    Обновить задачу фабрики (статус, приоритет, описание)

    taskId, status, priority, title, description

  • delete_content_task

    Удалить (архивировать) задачу фабрики

    taskId

  • enrich_content_task

    Обогатить задачу: RAG-поиск, аналитика, анализ конкурентов

    taskId, companyId, topic, description, keywords, mode

  • generate_content_plan

    Сгенерировать план статьи: структура, тезисы, tone

    taskId, prompt, topicId, topicTitle, mode

  • generate_article

    Сгенерировать полнотекстовую статью в Markdown

    taskId, planId, articleLength, mode

  • suggest_topics

    Предложить 10 подтем на основе enrichment-данных

    taskId, mode

  • save_enrichment_analysis

    Сохранить результат анализа от клиентского LLM

    taskId, aiAnalysis, usage

  • save_generated_plan

    Сохранить контент-план (JSON) от клиентского LLM

    taskId, plan, topicId, topicTitle, prompt, usage

  • save_generated_article

    Сохранить статью (Markdown) от клиентского LLM

    taskId, content, planId, usage

  • set_publication_url

    Установить URL опубликованной статьи для отслеживания BMR

    taskId, publishedUrl

  • detect_insights

    Детекция инсайтов (15 типов): content gaps, competitor wins

    companyId, insightType

  • list_content_tags

    Список тегов фабрики с количеством задач

  • list_publications

    Список опубликованного контента + метрики эффективности

    companyId