Documentation
Tools exposed by Wikipedia Trend Watch and the limits that apply.
Connect
Server URL: https://trends.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.
Tools
topic_trend
Daily Wikipedia pageviews for one topic with 7, 30 and 90 day averages, the peak day and the 7 day versus 90 day ratio, in one or more languages.
- Inputs: topic, days (optional, 30 to 365), languages (optional, up to 5 codes), format (optional, csv is Pro)
- Limits: Counts one lookup per language answered. Daily data changes once a day and is cached.
compare_topics
Compares 2 to 10 topics by average daily pageviews and by recent change.
- Inputs: topics, language (optional), format (optional, csv is Pro)
- Limits: Counts one lookup per topic answered. Topics per call by plan: 3 on Free, 10 at most.
spike_scan
Scans a batch of topics (or a saved watch) and ranks them by 7 day average versus 90 day average.
- Inputs: topics or watch_id, language (optional), threshold (optional), min_daily_views (optional), offset (optional), format (optional, csv is Pro)
- Limits: Counts one lookup per topic answered. At most 100 topics per call on Pro (3 on Free). A request budget applies per call; the rest continues with next_offset.
watch_topics
Saves a list of topics as a watch that is checked daily; spikes become alerts and one email digest per day.
- Inputs: name, topics, language (optional), threshold (optional), min_daily_views (optional)
- Limits: Free: 1 watch of 3 topics, read on demand with spike_scan. Pro: 10 watches of 100 topics with daily checks and email alerts. Does not run a lookup.
list_watches
Lists saved watches with their topics, last check, next check and unread alerts.
- Inputs: none
- Limits: No quota.
remove_watch
Deletes one watch and its alerts.
- Inputs: watch_id
- Limits: No quota. Cannot be undone.
get_alerts
Returns spike alerts, 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 |
|---|---|---|
| topic lookups | 60 | 5000 |
| topics per call | 3 | 100 |
| watches | 1 | 10 |
Network behaviour
Outbound requests use the user agent TidyButtonBot/1.0 (+https://trends.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.