Search the catalogue
search_catalogSearch a public library’s catalog by title, author, subject, or keyword to find books, eBooks, audiobooks, DVDs, and more with live availability and hold queues.
Instructions
Search a library's catalogue for books, eBooks, audiobooks, DVDs and more. Returns typed titles with live availability counts and hold queues. Use the title_id of a result with check_availability to see which branches have a copy on the shelf.
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": {
"query": "<query>"
},
"name": "search_catalog"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Results page. A page holds 20 titles at most libraries and 10 at some; `pages` gives the count. | |
| query | Yes | What to search for: a title, author, subject or keywords. At most 200 characters. | |
| format | No | Only this format: book, ebook, audiobook, eaudiobook, large_print, graphic_novel, picture_book, dvd, bluray, music_cd, magazine (or a platform format code such as BK). | |
| 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. | |
| search_type | No | keyword | |
| available_at_branch | No | Only titles with a copy available right now at this branch (name or code from list_branches). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | Yes | ||
| pages | Yes | ||
| query | Yes | ||
| total | Yes | Total matching titles across all pages. | |
| source | Yes | Provenance of the data. | |
| library | Yes | ||
| results | Yes | ||
| did_you_mean | Yes | The site's spelling suggestion, if it had one. |