MCP docs

MentionDrop MCP setup and tool reference

MentionDrop exposes a public MCP endpoint backed by the v1 API and your account API keys. Connect it to Claude, Cursor, Windsurf, Hermes, or any MCP-aware client to query brand mentions, competitor signals, demand signals, digests, and reply drafts.

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.

Ask your agent to set it up

Paste this prompt into Claude, Cursor, Windsurf, or any MCP-aware client and it will find the right config file and add MentionDrop for you.

Add MentionDrop as an MCP server.
Endpoint: https://www.mentiondrop.com/api/mcp
Auth header: Authorization: Bearer md_live_YOUR_KEY

Find my MCP config file and add the server entry.
If unsure which file, check for claude_desktop_config.json
or .cursor/mcp.json.

Replace md_live_YOUR_KEY with your API key from Settings before pasting.

Generic MCP client config

Works with Claude Desktop, Cursor, Windsurf, and any other client that accepts an HTTP MCP server.

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

Hermes config

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

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.

MCP launch page HTTP API docs OpenAPI