Watch a title for availability
watch_titleMonitor a library title on a schedule and send notifications when its availability changes, such as a copy returning to the shelf.
Instructions
Create a standing watch on a title using TinyFish Monitor. TinyFish re-reads the title's page on a schedule and detects when its availability changes (for example a copy comes back on the shelf). Notifications go to the webhook you pass, or to the alerts set up in the TinyFish dashboard. Use list_watches to see watches and their current availability.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"title_id": "<title_id>"
},
"name": "watch_title"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| library | No | Library system id such as "tpl" (Toronto), "vpl" (Vancouver), "chipublib" (Chicago). Get it from find_library. A city or library name also works. | |
| title_id | Yes | A title_id from search_catalog. | |
| check_every | No | How often TinyFish re-checks the page. | 6_hours |
| webhook_url | No | Optional public HTTPS endpoint TinyFish calls when the page changes. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| watch | Yes | ||
| source | Yes | Provenance of the data. | |
| already_existed | Yes | True if this title was already being watched; the existing watch is returned and nothing new is created. | |
| availability_at_creation | Yes |