MentionsAPI MCP Server

Verifica si la IA recomienda tu marca: menciones, clasificaciones y citas en ChatGPT, Claude, Gemini, Perplexity, AI Overviews, AI Mode y Bing Copilot.

GitHub

Documentación

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