MCP docs

MentionDrop MCP setup and tool reference

MentionDrop exposes a remote MCP endpoint backed by the v1 API and your account API keys. Connect it to Claude Code, Cursor, Claude Desktop, VS Code, ChatGPT, Codex, Hermes, or any other MCP-aware client to query brand mentions, competitor signals, demand signals, digests, and reply drafts. Eleven tools: seven read, four action.

Quick start

Create an API key in Settings, then verify it works:

curl https://www.mentiondrop.com/api/v1/me \
  -H "Authorization: Bearer YOUR_API_KEY"

A 200 response confirms your key is valid and shows your plan metadata. Then add the MCP endpoint to your agent client below.

Endpoint and auth

https://www.mentiondrop.com/api/mcp
Authorization: Bearer md_live_xxx

MCP uses the same API-key auth, account scoping, plan gates, and service logic as the HTTP API. Keys are prefixed md_live_. Create one in Settings.

Prefer buttons to config files? The install section on the MCP overview page has copy buttons and a one-click Cursor deeplink for every snippet below.

Claude Code

One command, then restart the session. Add --scope user to make MentionDrop available in every project.

claude mcp add --transport http mentiondrop https://www.mentiondrop.com/api/mcp --header "Authorization: Bearer md_live_YOUR_KEY"

Cursor

Use the one-click install on the MCP overview page, or add the entry to .cursor/mcp.json yourself.

{
  "mcpServers": {
    "mentiondrop": {
      "url": "https://www.mentiondrop.com/api/mcp",
      "headers": {
        "Authorization": "Bearer md_live_YOUR_KEY"
      }
    }
  }
}

Claude Desktop and generic clients

Add this to claude_desktop_config.json and restart the app. The same block works in Windsurf and most other clients that accept a remote HTTP MCP server.

{
  "mcpServers": {
    "mentiondrop": {
      "type": "http",
      "url": "https://www.mentiondrop.com/api/mcp",
      "headers": {
        "Authorization": "Bearer md_live_YOUR_KEY"
      }
    }
  }
}

macOS path: ~/Library/Application Support/Claude/claude_desktop_config.json

VS Code and Copilot

Register it from the command line:

code --add-mcp '{"name":"mentiondrop","type":"http","url":"https://www.mentiondrop.com/api/mcp","headers":{"Authorization":"Bearer md_live_YOUR_KEY"}}'

Or commit .vscode/mcp.json so everyone on the team gets the same tools:

{
  "servers": {
    "mentiondrop": {
      "type": "http",
      "url": "https://www.mentiondrop.com/api/mcp",
      "headers": {
        "Authorization": "Bearer md_live_YOUR_KEY"
      }
    }
  }
}

ChatGPT developer mode

ChatGPT can call remote MCP servers through developer mode on paid plans. Connector menus move around between releases, so if a label does not match, look under Settings then Connectors.

  1. Open Settings, go to Connectors, then enable developer mode under advanced settings.
  2. Create a new connector and name it mentiondrop.
  3. Paste the MCP server URL below.
  4. Set authentication to API key and paste your md_live_ key.
  5. Save, then enable the connector from the composer before asking for a digest.
https://www.mentiondrop.com/api/mcp

Codex and Hermes

Codex CLI reads the key from an environment variable, so export MENTIONDROP_API_KEY first.

codex mcp add mentiondrop --url https://www.mentiondrop.com/api/mcp --bearer-token-env-var MENTIONDROP_API_KEY

Hermes:

tools:
  mcp_servers:
    mentiondrop:
      type: http
      url: https://www.mentiondrop.com/api/mcp
      headers:
        Authorization: Bearer md_live_YOUR_KEY

Ask your agent to set it up

Paste this prompt before you have a key. Your agent will guide account creation, pause while you create the key, and then help store it securely and configure the correct MCP client.

Help me connect MentionDrop as a brand-intelligence MCP server to this agent.

I do not have a MentionDrop API key yet. If I do not already have an account, guide me to sign up at https://www.mentiondrop.com/sign-up?source=agent_setup_prompt. Then guide me to create an account-scoped API key in MentionDrop Settings.

Do not ask me to paste the key into chat or commit it to a repository. Tell me how to store it in this client's secret store or an environment variable.

Then configure the MCP server named "mentiondrop" at https://www.mentiondrop.com/api/mcp using an Authorization: Bearer header. When it is connected, verify it by calling list_keywords. Do not create keywords or post anything publicly unless I explicitly ask.

The prompt contains no API key. Never paste a live key into an agent chat or commit it to a repository.

Read tools

list_keywords

List monitored keywords for the authenticated account.

get_recent_mentions

Fetch recent mentions with optional role, keyword, source, sentiment, and date filters.

search_mentions

Search returned mentions by title, summary, URL, suggested action, or keyword.

get_competitor_signals

Fetch competitor-role mentions, optionally filtered to one competitor keyword.

get_pain_signals

Fetch industry/demand mentions likely to represent public pain signals.

get_digest

Return owned-brand, competitor, demand, and reply-worthy mention groups in one call.

get_mention

Fetch one account-owned mention by ID.

Action tools

create_keyword

Create a monitored keyword within plan limits and keyword-risk checks.

update_keyword

Update keyword metadata, relevance thresholds, active state, or filters.

mark_mention_reviewed

Mark a mention as relevant or not relevant after human review.

generate_reply_draft

Generate a reply or outreach email draft for a processed mention.

Useful prompts

Copy these directly into your agent or use them as starting points.

Use MentionDrop to find competitor complaints from the last week. Return signal URL, pain, risk, and suggested reply angle.
Show me demand signals worth replying to today. Keep it to five.
Summarise this week's market signals by owned brand, competitors, and category pain.
Generate a reply draft for this mention ID, but keep it useful and non-salesy.

How MentionDrop works

  • 1Sources are bounded and high-signal: Reddit, Google News, search results, and selected public web results. MentionDrop is not full social firehose coverage.
  • 2Action tools (create_keyword, update_keyword) make real changes to your account. Keep them behind human intent in agent workflows.
  • 3generate_reply_draft creates draft content for human review. It does not send or post anything automatically.