MentionsAPI

by mukul-dutt

297 downloads

Not rated

GitHub

About

Track brand mentions, ranks, and citations across ChatGPT, Claude, Gemini, Perplexity, Google AI Overviews, AI Mode, and Bing Copilot. MCP-native, pay-as-you-go, $1 free signup credit.

Details

Author: mukul-dutt
Downloads: 297
Categories: Marketing, AI, Other

- Four tools: mentions_check, mentions_watch, mentions_discover, mentions_compare
- Eight modes for mentions_check, including live UI scrapes and cached checks
- PAYG pricing with no subscriptions, $1 free signup credit
- Structured error handling with plain-English relay to the AI agent
- Agent skill pack available via npx skills add

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name MentionsAPI

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

Connect via a remote server (recommended, zero install) at https://api.mentionsapi.com/mcp using OAuth or a Bearer token (API key). For local usage, run npx -y @mentionsapi/mcp@latest and configure the API key as the MENTIONSAPI_KEY environment variable. Set up in claude.ai, Claude Code, Cursor, Windsurf, or ChatGPT Plus using provided configuration examples.

`mentions_check`

Check whether a brand is mentioned across AI search surfaces. 8 shippable modes: mode:quick ($0.02) hits the official LLM APIs in parallel; mode:perplexity_live ($0.25), mode:chatgpt_live ($0.10), mode:gemini_live ($0.10), mode:ai_overview ($0.05), mode:ai_mode ($0.10), mode:bing_copilot ($0.05) each hit one live UI surface for ground-truth citations + fan-out queries; mode:all_live ($0.50) bundles all 6 live surfaces in one call. Returns mentions, ranks, citations, fan-out queries, and brand entities per surface.

`mentions_watch`

Set up a persistent monitor that webhooks you when brand mentions, ranks, or citations change.

`mentions_discover`

Suggest queries to track for a given brand. Returns ~50 candidate queries spanning informational, commercial, and comparison intents.

`mentions_compare`

Compute the delta between two queries OR two brands. Useful for competitor analysis.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

{
    "mentionsapi": {
        "command": "npx",
        "args": [
            "-y",
            "@mentionsapi/mcp@latest"
        ],
        "env": {
            "MENTIONSAPI_KEY": "<YOUR_KEY>"
        }
    }
}

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

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)

| 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 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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

mentions_check

mentions_watch

mentions_discover

mentions_compare

Claude Desktop / Cursor

McpServers

MentionsAPI MCP Server

Two ways to connect

Option 1 — Remote server (recommended, zero install)

Option 2 — Local stdio server (npm)

Claude Code (~/.claude.json)

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

Tools (4)

8 modes for mentions_check

Pricing

Env vars (stdio server)

Error handling

Agent skills

Docs & links

License

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Context 7

Reactive Resume

`mentions_check`

`mentions_watch`

`mentions_discover`

`mentions_compare`

Claude Code (`~/.claude.json`)

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

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

8 modes for `mentions_check`