Mentionsapi MCP

مجتمعي التسويق والمبيعات

Check whether AI assistants recommend your brand: mentions, ranks and citations across ChatGPT, Claude, Gemini, Perplexity, Google AI Overviews and Copilot.

التثبيت

خطوات التثبيت موجودة في التوثيق أدناه. التوثيق

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. MentionsAPI MCP Server
  2. Two ways to connect
  3. Get started in 60 seconds
  4. Tools (4)
  5. 8 modes for mentions_check
  6. Pricing
  7. Env vars (stdio server)
  8. Error handling
  9. Agent skills
  10. Docs & links
  11. License

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

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



License

MIT

الأسئلة الشائعة

ما هو Mentionsapi MCP؟

Check whether AI assistants recommend your brand: mentions, ranks and citations across ChatGPT, Claude, Gemini, Perplexity, Google AI Overviews and Copilot.

كيف أثبّت Mentionsapi MCP؟

اتبع خطوات التثبيت في توثيقه المعروض في هذه الصفحة وفي مستودعه.

هل Mentionsapi MCP مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Mentionsapi MCP؟

ينشره mukul-dutt. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من القوائم المجتمعية awesome-mcp-servers ومستودع المشروع على GitHub. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.