LLM Brand Monitor MCP Server

Servidor MCP LLM Brand Monitor

Servidor MCP para LLM Brand Monitor — uma plataforma que rastreia como modelos de IA mencionam sua marca.

Conecte Claude, Cursor, Windsurf ou qualquer cliente compatível com MCP para gerenciar projetos de monitoramento de marca, executar varreduras em mais de 350 LLMs e analisar resultados — tudo por meio de linguagem natural.

Início Rápido

Claude Desktop

Adicione ao seu 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

A partir do código-fonte

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

Em seguida, adicione à configuração do seu 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

Obtendo uma Chave de API

1. Cadastre-se em llmbrandmonitor.com
2. Abra sua página de Perfil
3. Copie sua chave de API (começa com lbm_)

Ferramentas

17 ferramentas em 4 categorias:

Projetos (7 ferramentas)

Ferramenta	O que faz
lbm_list_projects	Lista todos os projetos de monitoramento de marca
lbm_get_project	Obtém detalhes do projeto com prompts e modelos
lbm_create_project	Cria um novo projeto
lbm_update_project	Atualiza nome do projeto, modelos ou configurações de monitoramento
lbm_archive_project	Arquiva um projeto
lbm_add_prompts	Adiciona prompts de monitoramento a um projeto
lbm_delete_prompt	Remove um prompt de um projeto

Varreduras (3 ferramentas)

Ferramenta	O que faz
lbm_run_scan	Inicia uma varredura — envia prompts aos LLMs e coleta respostas
lbm_get_scan_status	Verifica o progresso da varredura
lbm_list_scans	Visualiza o histórico de varreduras

Resultados (5 ferramentas)

Ferramenta	O que faz
lbm_list_results	Navega pelos resultados de monitoramento (menções à marca, status)
lbm_get_transcript	Lê a resposta completa do LLM para um resultado específico
lbm_list_competitors	Ver quais marcas concorrentes os LLMs mencionam
lbm_list_links	Ver quais URLs e domínios os LLMs citam
lbm_get_history	Tendências de menções a concorrentes ao longo do tempo

Modelos e Uso (2 ferramentas)

Ferramenta	O que faz
lbm_list_models	Lista mais de 350 modelos LLM disponíveis
lbm_get_usage	Verifica saldo de créditos e estatísticas de uso

Fluxo de Trabalho 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

Respostas Eficientes em Tokens

Todas as ferramentas de listagem retornam CSV compacto por padrão em vez de JSON detalhado. Isso reduz o uso de tokens em 80–96%, mantendo as respostas dentro dos limites 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 as ferramentas de listagem suportam offset e limit para paginação.

Configuração

Variável	Obrigatória	Padrão	Descrição
LBM_API_KEY	Sim	—	Chave de API de llmbrandmonitor.com
LBM_API_BASE_URL	Não	https://llmbrandmonitor.com/api/v1	URL base da API
LOG_LEVEL	Não	info	error, warn, info, debug

Tratamento de Erros

Erros incluem dicas acionáveis para o LLM:

Erro	Dica
INSUFFICIENT_CREDITS	Verifique o saldo com lbm_get_usage. Recarregue em llmbrandmonitor.com/pricing
RATE_LIMITED	Aguarde alguns segundos e tente novamente
NOT_FOUND	Chame lbm_list_projects para verificar se o ID existe
UNAUTHORIZED	Chave de API inválida — verifique LBM_API_KEY

Desenvolvimento

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

Documentação da API

Documentação completa da API REST: llmbrandmonitor.com/api-docs

Licença

MIT