MCP integration

MentionsAPI ships an MCP (Model Context Protocol) server so any compatible AI editor — Claude Code, Cursor, Windsurf — can call our API as native tools. Your AI assistant gets mentions_check, mentions_watch, mentions_discover, and mentions_compare as first-class tools.

What you get

  • mentions_check — your assistant can check brand mentions across 4 LLMs ($0.39, or $0.02 on cache hits) or scrape the Perplexity UI ($0.25). Mode picked automatically based on the natural-language ask.
  • mentions_watch — set up scheduled brand-rank watches with webhook delivery from inside the conversation.
  • mentions_discover — generate query candidates for a brand without leaving the editor.
  • mentions_compare — head-to-head delta between two brands or queries.

Remote server — claude.ai connector (zero install)

The fastest path. MentionsAPI hosts a remote MCP server with OAuth, so claude.ai (and Claude Desktop) connect with no install and no key copying:

http
https://api.mentionsapi.com/mcp
  1. Open claude.ai → Settings → Connectors and click Add custom connector.
  2. Paste the URL above and click Connect.
  3. Sign in to MentionsAPI if prompted, then click Allow on the consent screen.

Connecting creates an API key named “Claude” in /app/keys — revoke it there anytime to disconnect. The same URL also works in any Streamable-HTTP MCP client with an Authorization: Bearer lvk_live_… header (see the editor guides below), or grab ready-made snippets in the dashboard.

Local server — npm package

One-time install via npx. Replace lvk_live_... with your MentionsAPI key (create one at /app/keys).

bash
npx -y @mentionsapi/mcp@latest --api-key=lvk_live_...

The MCP server is a thin wrapper over our REST API — it forwards your bearer token and translates MCP JSON-RPC calls into HTTPS requests. No data is processed locally; your API key is the only secret.

Editor-specific setup

Pricing

Same as direct API access. Each MCP tool call is a single REST call billed at the mode's rate. The MCP server is free to install; the underlying API calls deduct from your wallet. Track spend at /v1/usage.