MentionsAPI MCP for Claude Code

Add MentionsAPI as an MCP server in Claude Code so your assistant can call /v1/check, /v1/discover, and /v1/compare as native tools.

1. Get an API key

Visit /app/keys to mint a fresh key. Use a separate key for MCP so you can revoke it without breaking your server-side integrations.

2. Add the MCP server

Edit your Claude Code settings file and add the mentionsapi server:

json
# ~/.config/claude-code/settings.json (or wherever your Claude Code config lives)
{
  "mcpServers": {
    "mentionsapi": {
      "command": "npx",
      "args": ["-y", "@mentionsapi/mcp@latest"],
      "env": {
        "MENTIONSAPI_API_KEY": "lvk_live_..."
      }
    }
  }
}

3. Verify

bash
# Restart Claude Code, then in any conversation:
"Use mentions_check to see if HubSpot is mentioned in 'best CRM for small business' across all 4 LLMs."

# Claude Code should call /v1/check?mode=quick automatically.

You should see Claude Code's tool-call indicator fire and a JSON response from MentionsAPI inline. The tool call appears in the dashboard's recent-calls list with your API key as the source.

Tools available

  • mentions_check — POST /v1/check
  • mentions_watch — POST /v1/watch
  • mentions_discover — POST /v1/discover
  • mentions_compare — POST /v1/compare

Schemas are introspected via zod-to-json-schema, so Claude Code gets full autocomplete and validation for every parameter. Mode names follow the same surface as the REST API: quick (default), perplexity_live, and realistic (deprecated alias).