Documentation
Tools exposed by Media Mention Watch and the limits that apply.
Connect
Server URL: https://mentions.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.
Tools
search_news
Searches recent news articles for a query, up to three months back, with GDELT operators for exact phrases, source country, source language and domain.
- Inputs: query, timespan (optional), max_results (optional), sort (optional)
- Limits: Counts one search when GDELT answers. If the shared request slot is busy it returns a retry time and counts nothing. Up to 75 articles.
mention_trend
Returns the daily number of matching articles and the daily average tone for a query, with the peak day.
- Inputs: query, timespan (optional)
- Limits: Counts one search when both series are returned. Uses two upstream requests, so it can take several seconds.
add_watch
Saves a query to be checked automatically for new articles and for spikes in daily volume.
- Inputs: name, query
- Limits: Saved query limit by plan. The first check records existing coverage without alerting.
list_watches
Lists saved queries with last check time, next check time and unread alert counts.
- Inputs: none
- Limits: No quota.
remove_watch
Deletes a saved query and its alerts.
- Inputs: watch_id
- Limits: No quota. Cannot be undone.
check_now
Runs one saved query immediately and reports new articles, and whether daily volume is spiking.
- Inputs: watch_id
- Limits: Counts one search when the check completes. Needs the shared request slot, so it can wait a few seconds or ask you to retry.
get_alerts
Returns alerts for new articles and volume spikes, unread first, and marks them read.
- Inputs: include_read (optional), watch_id (optional), limit (optional)
- Limits: No quota. Up to 50 per call.
account_status
Shows the account email, plan, usage and limits.
- Inputs: none
- Limits: none
activate_license
Binds a licence key to the account.
- Inputs: license_key (string)
- Limits: Key must belong to this product.
Plan limits
| Limit | Free | Pro |
|---|---|---|
| searches | 30 | 1500 |
| saved queries | 2 | 50 |
Network behaviour
Outbound requests use the user agent TidyButtonBot/1.0 (+https://mentions.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.