MentionsAPI MCP Server

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:

  Copy & paste — that's itCopy

  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)

8 modes for mentions_check

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)

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

• Quickstart — https://mentionsapi.com/docs/quickstart
• API reference — https://mentionsapi.com/docs/api/check
• MCP setup guides — https://mentionsapi.com/docs/mcp
• Recipes — https://mentionsapi.com/docs/recipes
• Privacy policy — https://mentionsapi.com/legal/privacy

License

MIT