# MentionDrop: agent integration guide

MentionDrop is bounded high-signal mention monitoring. It covers Reddit, Google News, search results, and selected public web results. Coverage and freshness vary by source. Ahrefs Firehose is optional and disabled by default; do not describe MentionDrop as full-web or real-time monitoring.

## Start here

1. Read [llms.txt](https://www.mentiondrop.com/llms.txt) for the product catalogue.
2. Read the [HTTP API docs](https://www.mentiondrop.com/docs/api) and [OpenAPI 3.1 document](https://www.mentiondrop.com/openapi/mentiondrop-v1.json) before calling the API.
3. For MCP clients, follow the [MCP setup guide](https://www.mentiondrop.com/docs/mcp) and use `https://www.mentiondrop.com/api/mcp`.
4. Get an account-scoped API key from the account owner's MentionDrop dashboard. Never share or reuse someone else's key.

## Safe operating model

Begin with read-only calls: `GET /api/v1/me`, `GET /api/v1/keywords`, `GET /api/v1/mentions`, and `GET /api/v1/digest`. Use the OpenAPI document for parameters, pagination, error handling, and account capability checks.

Ask for explicit user confirmation before any call that changes account state. Mutating HTTP calls are `POST /api/v1/keywords`, `PATCH /api/v1/keywords/:id`, and `PATCH /api/v1/mentions/:id`. `POST /api/v1/reply-drafts` generates a draft only; it does not publish or send a message.

The matching MCP tools `create_keyword`, `update_keyword`, and `mark_mention_reviewed` change account state. `generate_reply_draft` creates draft content but does not send it. Read tools include `list_keywords`, `get_recent_mentions`, `search_mentions`, `get_competitor_signals`, `get_pain_signals`, `get_digest`, and `get_mention`.

## Authentication

Use the account owner's API key with `Authorization: Bearer <API_KEY>` or `X-API-Key: <API_KEY>`. The key scopes every request and MCP call to that account. Validate it first with `GET /api/v1/me`.

## Source boundaries

Do not infer coverage outside the supported sources above. MentionDrop does not monitor general social platforms by default. Treat missing data as a coverage boundary, not evidence that no conversation exists.

## Canonical skill

---
name: mentiondrop-api
description: Use the MentionDrop HTTP API to list mentions, manage monitored keywords, build digests, and create reply drafts from market signals.
---

# MentionDrop API skill

## When to use

Use this skill when a user wants programmatic access to their MentionDrop market signals after creating an API key in the MentionDrop dashboard.

Good use cases:

- Find recent competitor complaints.
- Find Reddit or web conversations worth replying to.
- Summarise owned-brand, competitor, and demand signals.
- Create or update monitored keywords.
- Generate a reply or outreach draft for a processed mention.

## Base URL

Use the deployment origin, for example `https://www.mentiondrop.com`.

## Authentication

Send the user's API key on every request:

- `Authorization: Bearer YOUR_API_KEY`
- `X-API-Key: YOUR_API_KEY`

## Primary endpoints

- `GET /api/v1/me` — validate API key and inspect account capabilities.
- `GET /api/v1/mentions` — list processed mentions.
- `GET /api/v1/mentions/:id` — fetch one mention.
- `PATCH /api/v1/mentions/:id` — save relevant/not relevant feedback.
- `GET /api/v1/keywords` — list monitored keywords.
- `POST /api/v1/keywords` — create a monitored keyword.
- `PATCH /api/v1/keywords/:id` — update a monitored keyword.
- `GET /api/v1/digest` — grouped agent-friendly mention digest.
- `POST /api/v1/reply-drafts` — generate a reply or outreach draft.

## MCP endpoint

MentionDrop also exposes a public MCP endpoint at `/api/mcp`. Use the same API key with `Authorization: Bearer <MENTIONDROP_API_KEY>`.

Stable MCP v1 tools:

- `list_keywords`
- `create_keyword`
- `update_keyword`
- `get_recent_mentions`
- `search_mentions`
- `get_competitor_signals`
- `get_pain_signals`
- `get_digest`
- `get_mention`
- `mark_mention_reviewed`
- `generate_reply_draft`

## Workflow: competitor signals

1. Call `GET /api/v1/keywords` and find keywords with role `competitor`.
2. Call `GET /api/v1/digest` or `GET /api/v1/mentions` filtered to recent dates.
3. Rank mentions by relevance, sentiment, and whether a suggested action exists.
4. Return the URL, pain signal, risk, and suggested next action.

## Workflow: create monitors

1. Ask the user for brand, competitors, and industry pain phrases.
2. Create focused keywords with `POST /api/v1/keywords`.
3. Avoid broad generic terms unless the user gives narrowing context.

## Documentation

Prefer the OpenAPI document at `/openapi/mentiondrop-v1.json`, human-readable docs at `/docs/api`, and connector overview at `/integrations`.