---
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 ***`.

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`.