convez.ai
MCP ServerMarketing & VendasIntermediário
mukul-dutt

MentionsAPI MCP Server

mukul-dutt/mentionsapi-mcp

Rastreie menções de marca em todas as IA de busca em linguagem natural

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que integra a MentionsAPI para rastrear visibilidade de marca em todas as superfícies de busca por IA (ChatGPT, Claude, Gemini, Perplexity, Google AI Overviews e Bing Copilot). Permite consultar em linguagem natural se sua marca é mencionada e em qual posição em respostas de IA, com dados estruturados retornados diretamente no Claude.

Instalação

$npx convez-ai mukul-dutt/mentionsapi-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Monitorar posicionamento de marca em resultados de IA search
  • Comparar visibilidade entre marcas concorrentes
  • Descobrir queries relevantes para rastrear marca automaticamente
  • Investigar se marca aparece em recomendações de assistentes IA

Veredito

Ferramenta especializada e bem integrada para equipes de marketing e produto que precisam entender presença de marca em IA search. Preço por uso (PAYG) é transparente, mas requer créditos contratados; recomendado para quem já monitora concorrência em buscas tradicionais e quer expandir para IA.

README

A tradução para o português deste README ainda está na fila.

MentionsAPI MCP Server

npm version MIT License

Ask your AI agent whether AI recommends your brand. MentionsAPI tracks brand visibility across every AI search surface — ChatGPT, Claude, Gemini, Perplexity, Google AI Overviews, Google AI Mode, and Bing Copilot — and this MCP server puts that data inside any MCP-compatible client.

Ask in plain English. Get structured data back.

You: "Is HubSpot mentioned when users ask ChatGPT about CRMs?"
Claude: [calls mentions_check via MCP]
        "Yes — ranked 3rd in ChatGPT's answer. Top 3:
         HubSpot, Salesforce, Pipedrive. Fan-out queries
         issued during search: ..."

Two ways to connect

Option 1 — Remote server (recommended, zero install)

https://api.mentionsapi.com/mcp — Streamable HTTP with OAuth (one-click on claude.ai) or Authorization: Bearer lvk_live_....

  • claude.ai / Claude Desktop: Settings → Connectors → Add custom connector → paste the URL above, then approve via OAuth.

  • Claude Code:

    claude mcp add --transport http mentionsapi https://api.mentionsapi.com/mcp
    
  • Any Streamable-HTTP client: point it at the URL and send your API key as a Bearer token.

Option 2 — Local stdio server (npm)

npx -y @mentionsapi/mcp@latest

Claude Code (~/.claude.json)

{
  "mcpServers": {
    "mentionsapi": {
      "command": "npx",
      "args": ["-y", "@mentionsapi/mcp@latest"],
      "env": { "MENTIONSAPI_KEY": "lvk_live_..." }
    }
  }
}

Cursor (~/.cursor/mcp.json) — same shape

Windsurf (~/.codeium/windsurf/mcp_config.json) — same shape

ChatGPT Plus — see docs/mcp/chatgpt-plus


Get started in 60 seconds

  1. Sign up — free, no card, $1 free credit → https://mentionsapi.com/signup
  2. Mint an API key (looks like lvk_live_...) → https://mentionsapi.com/app/keys
  3. Connect using either option above
  4. Ask: "Use mentions_check to see if Notion appears for 'best CRM for startups' across all 4 LLMs."

Tools (4)

ToolWhat it doesCheapest mode
mentions_checkCheck if a brand is mentioned across AI search surfaces$0.02 (mode:quick, cached)
mentions_watchPersistent monitor with HMAC-signed webhook on changes$1/run
mentions_discoverSuggest 50 queries to track for a brand$0.50
mentions_compareSide-by-side delta between two brands$1.50

8 modes for mentions_check

ModeCostWhat
quick$0.39 fresh / $0.02 cachedAll 4 LLM APIs in parallel — ChatGPT, Claude, Gemini, Perplexity
perplexity_live$0.25Real Perplexity UI scrape — citations + fan-out queries
chatgpt_live$0.10Real ChatGPT UI scrape — fan-out + brand entities
gemini_live$0.10Real Gemini UI scrape
ai_overview$0.05Google's AI Overviews block
ai_mode$0.10Google's dedicated AI Mode
bing_copilot$0.05Bing Copilot AI overview
all_live$0.50All 6 live UI scrapes in one call

Pricing

PAYG only. No subscriptions, no monthly minimums.

  • $1 free signup credit — no card required
  • $5 minimum top-up — Stripe Checkout, card saved
  • Optional auto-recharge when wallet runs low

Top up: https://mentionsapi.com/app/billing


Env vars (stdio server)

VarRequiredDefault
MENTIONSAPI_KEYYes—
MENTIONSAPI_URLNohttps://api.mentionsapi.com

Error handling

The MCP returns structured errors the AI agent can relay to you in plain English:

  • auth_required — no API key set; includes signup URL
  • auth_invalid — key was rejected; rotate at /app/keys
  • insufficient_balance — wallet empty; top-up URL included
  • rate_limit_exceeded — includes retry_after_seconds
  • mode_roadmap — for deep/change_track (Q3 2026)

The server starts even without an API key — your AI agent will guide you through setup the first time you call a tool.


Agent skills

Prefer skills over raw tools? Install the companion skill pack:

npx skills add nikhonit/llm-mentions-skills

→ https://github.com/nikhonit/llm-mentions-skills


Docs & links


License

MIT

Ver o original no GitHub

Bom para

Relacionados