Documentation
Tools exposed by Literature Watch and the limits that apply.
Connect
Server URL: https://litwatch.tidybutton.com/mcp. Authentication is OAuth with dynamic client registration and an email sign-in code. Claude: Settings, Connectors, Add custom connector.
Tools
search_papers
Searches papers across the chosen sources by keywords, author, journal, date range, open access and type, merging and deduplicating the results.
- Inputs: query, author, journal (at least one), sources, date_from, date_to, open_access_only, type, sort, limit (optional)
- Limits: Counts one search when a source answers. Up to 50 papers. arXiv is limited to one request per call.
get_paper
Returns one paper by DOI, PubMed id or arXiv id with abstract, authors, venue, open access link and citation count.
- Inputs: id
- Limits: Counts one search when the paper is found.
add_watch
Saves a query with sources and optional author, journal, type and open access filters.
- Inputs: name, query / author / journal, sources, open_access_only, type
- Limits: Saved query limit by plan. The first check records recent papers 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 papers and current matches.
- Inputs: watch_id
- Limits: Counts one search when the check completes.
get_alerts
Returns new papers since the last check, deduplicated across sources, unread first, and marks them read.
- Inputs: include_read, watch_id, since_days, 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 | 50 | 2000 |
| saved queries | 3 | 100 |
Network behaviour
Outbound requests use the user agent TidyButtonBot/1.0 (+https://litwatch.tidybutton.com/bot), time out after 8 seconds and are blocked from private, loopback and link-local addresses.