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.
المحتويات
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:
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
- Sign up — free, no card, $1 free credit → https://mentionsapi.com/signup
- Mint an API key (looks like
lvk_live_...) → https://mentionsapi.com/app/keys - Connect using either option above
- Ask: "Use mentions_check to see if Notion appears for 'best CRM for startups' across all 4 LLMs."
Tools (4)
| Tool | What it does | Cheapest mode |
|---|---|---|
mentions_check | Check if a brand is mentioned across AI search surfaces | $0.02 (mode:quick, cached) |
mentions_watch | Persistent monitor with HMAC-signed webhook on changes | $1/run |
mentions_discover | Suggest 50 queries to track for a brand | $0.50 |
mentions_compare | Side-by-side delta between two brands | $1.50 |
8 modes for mentions_check
| Mode | Cost | What |
|---|---|---|
quick | $0.39 fresh / $0.02 cached | All 4 LLM APIs in parallel — ChatGPT, Claude, Gemini, Perplexity |
perplexity_live | $0.25 | Real Perplexity UI scrape — citations + fan-out queries |
chatgpt_live | $0.10 | Real ChatGPT UI scrape — fan-out + brand entities |
gemini_live | $0.10 | Real Gemini UI scrape |
ai_overview | $0.05 | Google's AI Overviews block |
ai_mode | $0.10 | Google's dedicated AI Mode |
bing_copilot | $0.05 | Bing Copilot AI overview |
all_live | $0.50 | All 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)
| Var | Required | Default |
|---|---|---|
MENTIONSAPI_KEY | Yes | — |
MENTIONSAPI_URL | No | https://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 URLauth_invalid— key was rejected; rotate at /app/keysinsufficient_balance— wallet empty; top-up URL includedrate_limit_exceeded— includesretry_after_secondsmode_roadmap— fordeep/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
الأسئلة الشائعة
ما هو 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. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.