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_xxxMCP 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.
- Open Settings, go to Connectors, then enable developer mode under advanced settings.
- Create a new connector and name it
mentiondrop. - Paste the MCP server URL below.
- Set authentication to API key and paste your
md_live_key. - Save, then enable the connector from the composer before asking for a digest.
https://www.mentiondrop.com/api/mcpCodex 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_KEYHermes:
tools:
mcp_servers:
mentiondrop:
type: http
url: https://www.mentiondrop.com/api/mcp
headers:
Authorization: Bearer md_live_YOUR_KEYAsk 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_keywordsList monitored keywords for the authenticated account.
get_recent_mentionsFetch recent mentions with optional role, keyword, source, sentiment, and date filters.
search_mentionsSearch returned mentions by title, summary, URL, suggested action, or keyword.
get_competitor_signalsFetch competitor-role mentions, optionally filtered to one competitor keyword.
get_pain_signalsFetch industry/demand mentions likely to represent public pain signals.
get_digestReturn owned-brand, competitor, demand, and reply-worthy mention groups in one call.
get_mentionFetch one account-owned mention by ID.
Action tools
create_keywordCreate a monitored keyword within plan limits and keyword-risk checks.
update_keywordUpdate keyword metadata, relevance thresholds, active state, or filters.
mark_mention_reviewedMark a mention as relevant or not relevant after human review.
generate_reply_draftGenerate a reply or outreach email draft for a processed mention.
Useful prompts
Copy these directly into your agent or use them as starting points.
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. - 3
generate_reply_draftcreates draft content for human review. It does not send or post anything automatically.