search_hadiths
Search Sahih al-Bukhari hadiths by text phrase, narrator, book, or topic to find matching entries with hadith numbers; combine filters to narrow results.
Instructions
Search Sahih al-Bukhari's hadiths by words in the text, narrator, book or topic.
Filters combine (AND). Each result is an entry with its hadith numbers and its whole matn; call get_hadith for the sanad, the chains and the full text.
total is how many entries match. To count, call with limit=1 and read total. A total of 0 means nothing matched: try a shorter phrase, or check the topic with list_topics.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_hadiths"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| book | No | Part of a book's name, such as الصوم. | |
| limit | No | Results per page, 1 to 50. | |
| query | No | A phrase as it appears in the hadith's text; it matches as one whole phrase, not as separate words. Diacritics and hamza forms do not matter. | |
| topic | No | A topic name, which must match exactly: take it from list_topics. | |
| offset | No | Results to skip: 0 for the first page, then the previous response's next_offset. | |
| narrator_id | No | Only hadiths with this narrator in a chain. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | How many entries match, across all pages. | |
| offset | Yes | How many entries this page skipped. | |
| results | Yes | ||
| next_offset | No | Pass as offset for the next page; null on the last page. |