LLM Brand Monitor MCP Server

Servidor MCP de LLM Brand Monitor

Servidor MCP para LLM Brand Monitor — una plataforma que rastrea cómo los modelos de IA mencionan tu marca.

Conecta Claude, Cursor, Windsurf o cualquier cliente compatible con MCP para gestionar proyectos de monitoreo de marca, ejecutar escaneos en más de 350 LLMs y analizar resultados, todo mediante lenguaje natural.

Inicio Rápido

Claude Desktop

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "lbm": {
      "command": "npx",
      "args": ["-y", "@serpstat/llm-brand-monitor-mcp"],
      "env": {
        "LBM_API_KEY": "lbm_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add lbm-mcp -e LBM_API_KEY=lbm_your_key_here -- npx -y @serpstat/llm-brand-monitor-mcp

Desde el Código Fuente

git clone https://github.com/SerpstatGlobal/llm-brand-monitor-mcp.git
cd llm-brand-monitor-mcp
npm install && npm run build

Luego añade a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "lbm": {
      "command": "node",
      "args": ["/path/to/llm-brand-monitor-mcp/dist/index.js"],
      "env": {
        "LBM_API_KEY": "lbm_your_key_here"
      }
    }
  }
}

MCP Inspector

LBM_API_KEY=lbm_your_key_here npx @modelcontextprotocol/inspector node dist/index.js

Cómo Obtener una Clave de API

1. Regístrate en llmbrandmonitor.com
2. Abre tu página de perfil
3. Copia tu clave de API (comienza con lbm_)

Herramientas

17 herramientas en 4 categorías:

Proyectos (7 herramientas)

Herramienta	Qué hace
lbm_list_projects	Lista todos los proyectos de monitoreo de marca
lbm_get_project	Obtén detalles del proyecto con prompts y modelos
lbm_create_project	Crea un nuevo proyecto
lbm_update_project	Actualiza el nombre del proyecto, modelos o configuración de monitoreo
lbm_archive_project	Archiva un proyecto
lbm_add_prompts	Añade prompts de monitoreo a un proyecto
lbm_delete_prompt	Elimina un prompt de un proyecto

Escaneos (3 herramientas)

Herramienta	Qué hace
lbm_run_scan	Inicia un escaneo: envía prompts a los LLMs y recopila respuestas
lbm_get_scan_status	Verifica el progreso del escaneo
lbm_list_scans	Consulta el historial de escaneos

Resultados (5 herramientas)

Herramienta	Qué hace
lbm_list_results	Explora los resultados de monitoreo (menciones de marca, estado)
lbm_get_transcript	Lee la respuesta completa del LLM para un resultado específico
lbm_list_competitors	Consulta qué marcas de la competencia mencionan los LLMs
lbm_list_links	Consulta qué URLs y dominios citan los LLMs
lbm_get_history	Tendencias de menciones de la competencia a lo largo del tiempo

Modelos y Uso (2 herramientas)

Herramienta	Qué hace
lbm_list_models	Lista más de 350 modelos LLM disponibles
lbm_get_usage	Consulta el saldo de créditos y estadísticas de uso

Flujo de Trabajo Típico

You: "What brand monitoring projects do I have?"
Claude: → lbm_list_projects

You: "Run a scan on the Serpstat project"
Claude: → lbm_run_scan (asks you to confirm — scans spend credits)
       → lbm_get_scan_status (polls until complete)

You: "Show me the results — which models mentioned my brand?"
Claude: → lbm_list_results

You: "What did GPT-5 say exactly?"
Claude: → lbm_get_transcript

You: "Who are my competitors according to AI models?"
Claude: → lbm_list_competitors

Respuestas Eficientes en Tokens

Todas las herramientas de listado devuelven CSV compacto por defecto en lugar de JSON verboso. Esto reduce el uso de tokens entre un 80 y un 96 %, manteniendo las respuestas dentro de los límites de contexto.

# Default (CSV) — 3-6 key columns
competitor,mentions,visibility_pct
Competitor A,178,72.4
Competitor B,105,42.7

# Full JSON — pass include_all_fields: true
{"data": [{"competitor_id": "...", "competitor_name": "Competitor A", ...}]}

Todas las herramientas de listado admiten offset y limit para paginación.

Configuración

Variable	Requerida	Predeterminado	Descripción
LBM_API_KEY	Sí	—	Clave de API de llmbrandmonitor.com
LBM_API_BASE_URL	No	https://llmbrandmonitor.com/api/v1	URL base de la API
LOG_LEVEL	No	info	error, warn, info, debug

Manejo de Errores

Los errores incluyen sugerencias accionables para el LLM:

Error	Sugerencia
INSUFFICIENT_CREDITS	Verifica el saldo con lbm_get_usage. Recarga en llmbrandmonitor.com/pricing
RATE_LIMITED	Espera unos segundos y reintenta
NOT_FOUND	Llama a lbm_list_projects para verificar que el ID exista
UNAUTHORIZED	La clave de API no es válida: verifica LBM_API_KEY

Desarrollo

npm install
npm run build    # TypeScript → dist/
npm test         # 126 tests

Documentación de la API

Documentación completa de la API REST: llmbrandmonitor.com/api-docs

Licencia

MIT