brandfound.

Command Palette

Search for a command to run...

MCP Server

Conexión del servidor MCP

El Model Context Protocol permite que los asistentes de IA trabajen directamente con brandfound.: gestionar empresas, analizar menciones y crear contenido desde el chat. Cada tool MCP es una llamada HTTP a API v1. Algunos endpoints están optimizados para el flujo de MCP (context_only para la Fábrica, setup atómico para consultas).

Endpoint MCP

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

OAuth 2.1 + PKCE

Autorización segura mediante el navegador. La clave API se crea automáticamente al primer conectarse. El token es válido durante 90 días. Puedes revocar el acceso en la configuración.

Autorización
ProtocoloOAuth 2.1
PKCES256
TransporteHTTP
Tokens
Prefijogfx_
TTL90 días
FormatoBearer
Discovery
Protected Resource/.well-known/oauth-protected-resource
Authorization Server/.well-known/oauth-authorization-server

Elige un asistente de IA

Pulsa el cliente que necesites — se abrirán las instrucciones de conexión.

Herramientas disponibles

50

Una vez conectado, el conector expone estas funciones de brandfound. al cliente LLM. El cliente elige las que necesita según la tarea.

Espacios de trabajo

2

Un token para todos tus espacios

  • •El token OAuth tiene un espacio activo, inicialmente el de inicio de sesión. switch_workspace selecciona otro donde tengas una invitación ACCEPTED.
  • •El cambio persiste en ApiKey.activeAccountId y se aplica a todos los clientes MCP de esta clave en su siguiente solicitud, incluidos Claude Desktop y Cursor. Sin volver a iniciar sesión.
  • •El acceso se comprueba en CADA solicitud. Si te eliminan del equipo, la siguiente herramienta vuelve al espacio original del token, sin 401.
  • •El cambio también restablece preferredCompanyId, asociado al espacio anterior.
  • list_workspaces

    Lista de espacios accesibles: propio y TeamMember ACCEPTED, indicando el activo

  • switch_workspace

    Cambia el espacio activo de la clave API de forma persistente; restablece preferredCompanyId

    accountId

Empresas y productos

7

v1.1: upsert sustituye los pares create/update

  • •save_company / save_competitor / save_product sustituyen create_* y update_*: sin id crean; con id solo actualizan los campos enviados.
  • •Actualizar synonyms sustituye toda la lista, sin combinar. Envía el array completo al ampliarla.
  • list_companies

    Empresas del usuario con búsqueda y paginación

    search, limit, offset, sortBy, sortOrder

  • get_company

    Detalles de una empresa y sus productos

    companyId

  • save_company

    Crea o actualiza una empresa; sin companyId crea. regionTargets define países de medición y el país para generar consultas.

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

  • get_company_categories

    Directorio de categorías de empresas: sectores y nichos

  • search_geo

    Países, ciudades e idiomas con UUID para regionTargets y defaultLanguageId

    kind, q, countryIso2, limit

  • save_competitor

    Crea o actualiza un competidor; sin competitorId crea

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

  • save_product

    Crea o actualiza un producto, incluida la reasignación de intents (upsert)

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

Palabras clave

3

v1.1: ciclo de vida mediante action

  • •manage_keyword reúne create / rename / archive / restore / delete mediante action. archive y delete admiten dryRun.
  • •link_keywords combina attach por nombre (find-or-create) y detach por keywordIds para company / product / competitor.
  • list_keywords

    Palabras clave filtradas por target y estado

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

  • manage_keyword

    Gestiona una palabra clave: create / rename / archive / restore / delete

    action, keywordId, name, attach, dryRun

  • link_keywords

    Asocia palabras clave por nombre o desvincúlalas por id de un target, en lote

    action, target, names, keywordIds

Analítica y métricas

9

v1.1: informes unificados

  • •get_analytics_report sustituye seis herramientas con report: overview / keywords / timeline / recent / geo / cluster.
  • •get_trends combina temas estratégicos (scope="topics",7–30 días) y señales tácticas (scope="pulse",6–72 horas).
  • get_competitor_analytics

    Análisis competitivo: Share of Voice y líderes

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

  • get_brand_visibility

    Evolución del Brand Mention Rate (BMR): visibilidad de marca

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

  • get_tonality

    Análisis de sentimiento: sentiment, fairness, helpfulness y más de 10 métricas

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

  • list_mentions

    Menciones de marca en respuestas de IA con filtros

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

  • list_queries

    Consultas a IA con respuestas y analítica

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

  • get_trends

    Tendencias: scope="topics" (estrategia,7–30 días) o scope="pulse" (señales,6–72 horas)

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

  • get_analytics_report

    Informe resumen: overview / keywords / timeline / recent / geo / cluster

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

  • list_query_labels

    Etiquetas y clústeres con número de consultas

    companyId, q, limit, offset, lite

  • list_notifications

    Notificaciones del usuario (WIDGET / BANNER / TOAST / EMAIL)

    limit, offset, type, includeDismissed

Consultas

7

Dos opciones: tu agente escribe consultas o el servicio las genera

  • •setup_queries usa BYO-LLM: tu agente escribe consultas con la ficha de marca (get_brand_card) y los competidores (get_company). Gratis; solo pagas los tokens de tu LLM.
  • •autogenerate_queries crea BORRADORES a 1 FoxCoin por consulta, sin consultar modelos. approve_query_drafts inicia consultas de pago a 10 FoxCoin por respuesta (consulta×modelo). Ejecuta dryRun y muestra el presupuesto antes de aprobar.
  • •Seis tipos: neutral, commercial, informational (sin marcas), comparative (marca+competidor en la base), reputational y branded (marca en el texto). Se aceptan los alias antiguos negative/general.
  • •La generación usa la región de la empresa (save_company.regionTargets). Para varios países, envía targets: una tarea por país e idioma oficial predeterminado (AE→ar,IN→hi).
  • •list_answers exporta hasta 200 respuestas por llamada con enlaces y menciones, sin bucles por consulta.
  • setup_queries

    Crea consultas escritas por tu agente con clústeres y consultas de IA opcionales de pago

    companyId, clusters, providers

  • autogenerate_queries

    Genera borradores sin consultar modelos de IA (1 FoxCoin por consulta)

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

  • get_autogeneration_status

    Progreso de generación: RUNNING / OK / FAILED / CANCELLED

    clientToken, runId, limit

  • list_query_drafts

    Consultas generadas pendientes de aprobación

    status, companyId, type, page, limit

  • approve_query_drafts

    Aprueba borradores e inicia consultas de pago a los modelos elegidos; dryRun solo estima costes

    draftIds, providers, dryRun

  • reject_query_drafts

    Rechaza borradores gratis, sin consultar modelos

    draftIds

  • list_answers

    Respuestas de IA por lotes: enlaces, menciones, brandDomainCited

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

Factory

13

v1.1: BYO-LLM predeterminado; solo mode="generate" explícito es de pago

  • •enrich_content_task / generate_content_plan / generate_article usan mode="context_only" por defecto y devuelven prompt y contexto. El LLM del cliente redacta y guarda con save_*, sin cobrar FoxCoin.
  • •mode="generate" explícito ejecuta generación de pago en el servidor: enriquecimiento 20 FC, plan 50 FC, artículo 70 FC; saldo insuficiente 402 INSUFFICIENT_FOXCOINS.
  • •suggest_topics se eliminó. El agente propone otros enfoques a partir del contexto enriquecido y envía topicTitle a generate_content_plan.
  • •manage_content_task reúne create / update / archive de tareas kanban mediante action.
  • list_content_tasks

    Tareas kanban de la fábrica con filtros

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

  • get_content_task

    Tarea completa, incluido su artículo guardado

    id

  • manage_content_task

    Crea / actualiza / archiva una tarea mediante action

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

  • enrich_content_task

    Enriquece una tarea: búsqueda RAG, analítica y competidores (context_only gratis; generate 20 FC)

    taskId, companyId, topic, description, keywords, mode

  • generate_content_plan

    Plan de artículo: estructura, ideas clave y tone (context_only gratis; generate 50 FC)

    taskId, prompt, topicId, topicTitle, mode

  • generate_article

    Artículo completo en Markdown (context_only gratis; generate 70 FC)

    taskId, planId, articleLength, mode

  • save_enrichment_analysis

    Guarda el análisis del LLM del cliente

    taskId, aiAnalysis, usage

  • save_generated_plan

    Guarda el plan JSON del LLM del cliente

    taskId, plan, topicId, topicTitle, prompt, usage

  • save_generated_article

    Guarda el artículo Markdown del LLM del cliente

    taskId, content, planId, usage

  • set_publication_url

    Define la URL publicada para seguir el BMR

    taskId, publishedUrl

  • detect_insights

    Detecta 15 tipos de oportunidades: vacíos de contenido, éxitos rivales; gratis, basado en reglas

    companyId, insightType

  • list_content_tags

    Etiquetas de la fábrica con número de tareas

  • list_publications

    Contenido publicado y métricas de rendimiento

    companyId

Tarjeta de marca

5

Tu agente puede leer y gestionar toda la ficha de marca

  • •La ficha es un árbol Markdown: instruction.md se envía primero; main / settings.md siempre se aplica, junto con archivos y carpetas de productos, datos, casos y FAQ.
  • •Los archivos se enlazan con [Nombre](brandcard://<id>), usando el ID del índice. Los enlaces sobreviven al cambio de nombre y priorizan archivos vinculados. Límite de inyección: unos 60.000 caracteres.
  • •Los bloques ```private se eliminan antes de enviar a la IA. save_brand_card_file sobrescribe todo el archivo: léelo antes de editar.
  • •Flujo recomendado: get_brand_card_index (estructura+enlaces) → get_brand_card_file para rutas necesarias → save_brand_card_file. Prompt MCP manage-brand-card: fill / audit / restructure.
  • get_brand_card

    Ficha completa en Markdown: manifiesto → core → vinculados → otros; sin bloques privados

    companyId

  • get_brand_card_index

    Índice: manifiesto y archivos con path, id, isCore y enlaces salientes

    companyId

  • get_brand_card_file

    Archivo por ruta: content conserva enlaces brandcard:// intactos; links los resuelve a rutas

    companyId, path

  • save_brand_card_file

    Crea o sobrescribe un archivo por ruta; las carpetas se crean automáticamente

    companyId, path, content

  • delete_brand_card_file

    Elimina archivos o carpetas recursivamente; no se elimina la estructura protegida

    companyId, path