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.

Articles mentioning "Tidy Button" from the last 7 days, English only.

mention_trend

Returns the daily number of matching articles and the daily average tone for a query, with the peak day.

How did coverage of my product launch change over the last 30 days?

add_watch

Saves a query to be checked automatically for new articles and for spikes in daily volume.

Watch "Acme Corp" sourcelang:english.

list_watches

Lists saved queries with last check time, next check time and unread alert counts.

Show my saved media queries.

remove_watch

Deletes a saved query and its alerts.

Stop watching the Acme query.

check_now

Runs one saved query immediately and reports new articles, and whether daily volume is spiking.

Check my Acme query now.

get_alerts

Returns alerts for new articles and volume spikes, unread first, and marks them read.

Any new coverage?

account_status

Shows the account email, plan, usage and limits.

Show my account status.

activate_license

Binds a licence key to the account.

Activate licence key XXXX-XXXX.

Plan limits

LimitFreePro
searches301500
saved queries250

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.