HadithDB MCP
Provides read-only access to search and retrieve Quran ayahs, tafsir commentary, hadith collections, and detailed hadith records including narrator chains and grading. Supports research workflows for Islamic topics and Quranic verses with depth-dependent source aggregation.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
MCP endpoint (Streamable HTTP)
https://hadithunlocked.com/mcpWhat its tools do
19 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (19)
search_bloglookup_blog_postlist_hadith_commentariessearch_hadith_commentarylookup_hadith_commentaryresearch_islamic_topicresearch_quran_ayahlookup_quran_pagelist_quran_sectionslookup_quran_passagelist_quran_recitersget_quran_audiolookup_quran_ayahsearch_quranlist_tafsirslookup_tafsirsearch_tafsirsearch_hadithlookup_hadith_detail
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Search hadith collections in Arabic and English
- Lookup detailed hadith records with narrator chains
- Research Islamic topics with depth-dependent commentary
- Retrieve Quran ayah explanations and tafsir
Source and maintenance
Community listingRegistry 0.2.0
- Maintenance checked
Protocol and capabilities
- Server
- HadithDB 0.9.0
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 19 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
Server-advertised capabilities
{
"tools": {},
"extensions": {
"io.modelcontextprotocol/skills": {}
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
19 advertised
search_blog — Search blog
Advertised read-onlyOpen-world
Search published HadithDB blog articles by words or phrases in their public titles and text. Results are editorial discovery candidates, distinct from Quran, hadith, tafsir and shuruh. Verify any cited reports with the source lookup tools. Use lookup_blog_post for complete article text.
search_blog input schema
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"cursor": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
}search_blog output schema
{
"type": "object",
"oneOf": [
{
"required": [
"query",
"results",
"pagination"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
},
"query": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"title",
"url",
"author",
"published_at",
"updated_at",
"source_type",
"text",
"truncated"
],
"properties": {
"id": {
"type": "integer"
},
"url": {
"type": "string"
},
"text": {
"type": "string"
},
"title": {
"type": "string"
},
"author": {
"type": [
"string",
"null"
]
},
"truncated": {
"type": "boolean"
},
"updated_at": {
"type": [
"string",
"null"
]
},
"source_type": {
"enum": [
"editorial_blog"
],
"type": "string"
},
"published_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"pagination": {
"type": "object",
"required": [
"limit",
"returned",
"offset",
"total_available",
"total_is_exact",
"has_more",
"next_cursor"
],
"properties": {
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"has_more": {
"type": "boolean"
},
"returned": {
"type": "integer"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"total_is_exact": {
"type": "boolean"
},
"total_available": {
"type": [
"integer",
"null"
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}search_blog annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}lookup_blog_post — Look up blog post
Advertised read-onlyOpen-world
Retrieve a published blog article by its ID from search_blog. Preserves its author, canonical URL and public Markdown. Editorial interpretation is not independently authenticated scripture. Default bounds text to 6000 characters; full returns the complete article.
lookup_blog_post input schema
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"minimum": 1
},
"response_profile": {
"enum": [
"compact",
"default",
"full"
],
"type": "string",
"default": "default"
}
},
"additionalProperties": false
}lookup_blog_post output schema
{
"type": "object",
"oneOf": [
{
"required": [
"post"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"post": {
"type": "object",
"required": [
"id",
"title",
"url",
"author",
"published_at",
"updated_at",
"source_type",
"text",
"truncated"
],
"properties": {
"id": {
"type": "integer"
},
"url": {
"type": "string"
},
"text": {
"type": "string"
},
"title": {
"type": "string"
},
"author": {
"type": [
"string",
"null"
]
},
"truncated": {
"type": "boolean"
},
"updated_at": {
"type": [
"string",
"null"
]
},
"source_type": {
"enum": [
"editorial_blog"
],
"type": "string"
},
"published_at": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
}
},
"additionalProperties": false
}lookup_blog_post annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}list_hadith_commentaries — List hadith commentaries
Advertised read-onlyOpen-world
Use this to discover available hadith commentary works (shuruh), authors and aliases before selecting a source. These are commentary works, not the underlying hadith collections. Catalog presence does not guarantee coverage of a particular report.
list_hadith_commentaries input schema
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 100,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 200
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0
}
},
"additionalProperties": false
}list_hadith_commentaries output schema
{
"type": "object",
"oneOf": [
{
"required": [
"sources",
"total",
"next_offset"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
},
"total": {
"type": "integer"
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"alias",
"title_arabic",
"title_english",
"author_arabic",
"author_english"
],
"properties": {
"id": {
"type": [
"integer",
"null"
]
},
"alias": {
"type": [
"string",
"null"
]
},
"title_arabic": {
"type": [
"string",
"null"
]
},
"author_arabic": {
"type": [
"string",
"null"
]
},
"title_english": {
"type": [
"string",
"null"
]
},
"author_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"next_offset": {
"type": [
"integer",
"null"
]
}
},
"additionalProperties": false
}list_hadith_commentaries annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}search_hadith_commentary — Search hadith commentary
Advertised read-onlyOpen-world
Use this for scholarly explanations, procedural details and disagreements, including when answering how to perform worship or researching Quranic concepts. Searches shuruh across collections. Results preserve the commentary work and associated hadith separately. Retrieve exact entries with lookup_hadith_commentary and verify reports with lookup_hadith_detail.
search_hadith_commentary input schema
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"cursor": {
"type": "string",
"minLength": 1
},
"source": {
"type": "string",
"minLength": 1,
"description": "Optional exact commentary alias from list_hadith_commentaries."
},
"reference": {
"type": "string",
"minLength": 3,
"description": "Optional exact associated hadith reference."
}
},
"additionalProperties": false
}search_hadith_commentary output schema
{
"type": "object",
"oneOf": [
{
"required": [
"query",
"results",
"pagination"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
},
"query": {
"type": "string"
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"source",
"hadith_reference",
"hadith_collection",
"url",
"text_arabic",
"text_english",
"truncated"
],
"properties": {
"id": {
"type": "integer"
},
"url": {
"type": "string"
},
"source": {
"type": "object",
"required": [
"id",
"alias",
"title_arabic",
"title_english",
"author_arabic",
"author_english"
],
"properties": {
"id": {
"type": [
"integer",
"null"
]
},
"alias": {
"type": [
"string",
"null"
]
},
"title_arabic": {
"type": [
"string",
"null"
]
},
"author_arabic": {
"type": [
"string",
"null"
]
},
"title_english": {
"type": [
"string",
"null"
]
},
"author_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"truncated": {
"type": "boolean"
},
"text_arabic": {
"type": [
"string",
"null"
]
},
"text_english": {
"type": [
"string",
"null"
]
},
"hadith_reference": {
"type": "string"
},
"hadith_collection": {
"type": "string"
}
},
"additionalProperties": false
}
},
"pagination": {
"type": "object",
"required": [
"limit",
"returned",
"offset",
"total_available",
"total_is_exact",
"has_more",
"next_cursor"
],
"properties": {
"limit": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"has_more": {
"type": "boolean"
},
"returned": {
"type": "integer"
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"total_is_exact": {
"type": "boolean"
},
"total_available": {
"type": [
"integer",
"null"
]
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}search_hadith_commentary annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}lookup_hadith_commentary — Look up hadith commentary
Advertised read-onlyOpen-world
Retrieve an exact scholarly commentary entry by ID from commentary search or a hadith’s research inventory. Preserve its author and work attribution. Default bounds each language to 6000 characters; full retrieves all indexed text.
lookup_hadith_commentary input schema
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"minimum": 1
},
"response_profile": {
"enum": [
"compact",
"default",
"full"
],
"type": "string",
"default": "default"
}
},
"additionalProperties": false
}lookup_hadith_commentary output schema
{
"type": "object",
"oneOf": [
{
"required": [
"commentary"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
},
"commentary": {
"type": "object",
"required": [
"id",
"source",
"hadith_reference",
"hadith_collection",
"url",
"text_arabic",
"text_english",
"truncated"
],
"properties": {
"id": {
"type": "integer"
},
"url": {
"type": "string"
},
"source": {
"type": "object",
"required": [
"id",
"alias",
"title_arabic",
"title_english",
"author_arabic",
"author_english"
],
"properties": {
"id": {
"type": [
"integer",
"null"
]
},
"alias": {
"type": [
"string",
"null"
]
},
"title_arabic": {
"type": [
"string",
"null"
]
},
"author_arabic": {
"type": [
"string",
"null"
]
},
"title_english": {
"type": [
"string",
"null"
]
},
"author_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"truncated": {
"type": "boolean"
},
"text_arabic": {
"type": [
"string",
"null"
]
},
"text_english": {
"type": [
"string",
"null"
]
},
"hadith_reference": {
"type": "string"
},
"hadith_collection": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}lookup_hadith_commentary annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}research_islamic_topic — Research an Islamic topic
Advertised read-onlyOpen-world
Use this before answering substantive Islamic topic or practical worship questions, such as what istikharah is and how to pray it. Collects Quran/tafsir discovery candidates, verified hadith records, explanations from distinct shuruh, explicitly linked related reports, and published blog articles as attributed editorial context. Supply short Arabic/English queries and known principal hadith_references when available to anchor the research. Inspect coverage and fetch omitted/truncated sources as needed within the same turn; do not treat topic matches as direct evidence or claim exhaustive research.
research_islamic_topic input schema
{
"type": "object",
"required": [
"question",
"queries"
],
"properties": {
"depth": {
"enum": [
"brief",
"standard",
"deep"
],
"type": "string",
"default": "standard",
"description": "Research breadth, independent of the final answer length. All depths have time and source limits."
},
"queries": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 4,
"minItems": 1,
"description": "Short concept search phrases, preferably including Arabic equivalents. Do not pass the entire natural-language question as a search phrase."
},
"question": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"hadith_references": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 3
},
"maxItems": 4,
"description": "Known exact principal report references to prioritize and verify, e.g. bukhari:1166. Do not invent references or translate source numbers across collections."
}
},
"additionalProperties": false
}research_islamic_topic output schema
{
"type": "object",
"oneOf": [
{
"required": [
"question",
"depth",
"scope",
"queries",
"evidence",
"coverage",
"next_steps",
"interpretation_note"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"depth": {
"type": "string"
},
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
},
"scope": {
"type": "string"
},
"queries": {
"type": "array",
"items": {
"type": "string"
}
},
"coverage": {
"type": "object",
"required": [
"exhaustive",
"calls_made",
"call_limit",
"time_limit_ms",
"deadline_reached",
"hadith_commentary",
"concept_research",
"blog",
"omitted_candidates"
],
"properties": {
"blog": {
"enum": [
"found",
"searched_no_match",
"not_searched",
"unavailable"
],
"type": "string"
},
"call_limit": {
"type": "integer"
},
"calls_made": {
"type": "integer"
},
"exhaustive": {
"type": "boolean"
},
"time_limit_ms": {
"type": "integer"
},
"concept_research": {
"enum": [
"found",
"searched_no_match",
"not_searched",
"unavailable"
],
"type": "string"
},
"deadline_reached": {
"type": "boolean"
},
"hadith_commentary": {
"enum": [
"found",
"searched_no_match",
"not_searched",
"unavailable"
],
"type": "string"
},
"omitted_candidates": {
"type": "integer"
}
},
"additionalProperties": false
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"required": [
"tool",
"arguments",
"relationship",
"status",
"data",
"error"
],
"properties": {
"data": {
"type": [
"object",
"null"
],
"description": "Selected source fields and bounded excerpts from the named tool. Truncated text is flagged; exact tools provide complete records. Search hits are discovery candidates, not verified conceptual relationships.",
"additionalProperties": true
},
"tool": {
"type": "string"
},
"error": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"found",
"searched_no_match",
"not_searched",
"unavailable"
],
"type": "string"
},
"arguments": {
"type": "object",
"additionalProperties": true
},
"relationship": {
"type": "string"
}
},
"additionalProperties": false
}
},
"question": {
"type": "string"
},
"next_steps": {
"type": "array",
"items": {
"type": "string"
}
},
"interpretation_note": {
"type": "string"
}
},
"additionalProperties": false
}research_islamic_topic annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}research_quran_ayah — Research a Quran ayah and its concepts
Advertised read-onlyOpen-world
Use this for explanations of Quran ayahs. Retrieves the exact ayah and major available tafsirs (default Tabari, Ibn Kathir, Qurtubi; more at deep depth), then searches supplied concepts in Quran, tafsir, hadith, shuruh and published blog articles (editorial context). If concepts are omitted, read the returned ayah/tafsirs, derive short grounded concept phrases, and call again with concepts without asking the user. Search matches are conceptual candidates, not proof a hadith directly explains this ayah. Verify relevant source text before synthesis. Respect explicitly requested tafsir sources.
research_quran_ayah input schema
{
"type": "object",
"required": [
"surah",
"ayah"
],
"properties": {
"ayah": {
"type": "integer",
"maximum": 286,
"minimum": 0
},
"depth": {
"enum": [
"brief",
"standard",
"deep"
],
"type": "string",
"default": "standard",
"description": "Research breadth, independent of the final answer length. All depths have time and source limits."
},
"surah": {
"type": "integer",
"maximum": 114,
"minimum": 1
},
"tafsirs": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"maxItems": 6,
"minItems": 1,
"description": "Optional requested source names/aliases; overrides the default source selection."
},
"concepts": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 4,
"minItems": 1,
"description": "Short concept search phrases, preferably including Arabic equivalents. Do not pass the entire natural-language question as a search phrase."
},
"hadith_references": {
"type": "array",
"items": {
"type": "string",
"maxLength": 100,
"minLength": 3
},
"maxItems": 4,
"description": "Known exact principal report references to prioritize and verify, e.g. bukhari:1166. Do not invent references or translate source numbers across collections."
}
},
"additionalProperties": false
}research_quran_ayah output schema
{
"type": "object",
"oneOf": [
{
"required": [
"question",
"depth",
"scope",
"queries",
"evidence",
"coverage",
"next_steps",
"interpretation_note"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"depth": {
"type": "string"
},
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
},
"scope": {
"type": "string"
},
"queries": {
"type": "array",
"items": {
"type": "string"
}
},
"coverage": {
"type": "object",
"required": [
"exhaustive",
"calls_made",
"call_limit",
"time_limit_ms",
"deadline_reached",
"hadith_commentary",
"concept_research",
"blog",
"omitted_candidates"
],
"properties": {
"blog": {
"enum": [
"found",
"searched_no_match",
"not_searched",
"unavailable"
],
"type": "string"
},
"call_limit": {
"type": "integer"
},
"calls_made": {
"type": "integer"
},
"exhaustive": {
"type": "boolean"
},
"time_limit_ms": {
"type": "integer"
},
"concept_research": {
"enum": [
"found",
"searched_no_match",
"not_searched",
"unavailable"
],
"type": "string"
},
"deadline_reached": {
"type": "boolean"
},
"hadith_commentary": {
"enum": [
"found",
"searched_no_match",
"not_searched",
"unavailable"
],
"type": "string"
},
"omitted_candidates": {
"type": "integer"
}
},
"additionalProperties": false
},
"evidence": {
"type": "array",
"items": {
"type": "object",
"required": [
"tool",
"arguments",
"relationship",
"status",
"data",
"error"
],
"properties": {
"data": {
"type": [
"object",
"null"
],
"description": "Selected source fields and bounded excerpts from the named tool. Truncated text is flagged; exact tools provide complete records. Search hits are discovery candidates, not verified conceptual relationships.",
"additionalProperties": true
},
"tool": {
"type": "string"
},
"error": {
"type": [
"string",
"null"
]
},
"status": {
"enum": [
"found",
"searched_no_match",
"not_searched",
"unavailable"
],
"type": "string"
},
"arguments": {
"type": "object",
"additionalProperties": true
},
"relationship": {
"type": "string"
}
},
"additionalProperties": false
}
},
"question": {
"type": "string"
},
"next_steps": {
"type": "array",
"items": {
"type": "string"
}
},
"interpretation_note": {
"type": "string"
}
},
"additionalProperties": false
}research_quran_ayah annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}lookup_quran_page — Look up Quran page
Advertised read-onlyOpen-world
Get a Mushaf page by page number, or find the first page containing a surah and ayah. Returns edition information, ayah/word boundaries, all overlapping passage and subsection headings, stored introductions, and a page overview assembled from those headings. The overview is not a separately authored summary or Quran text. Ayahs and passages may continue across pages.
lookup_quran_page input schema
{
"type": "object",
"oneOf": [
{
"not": {
"anyOf": [
{
"required": [
"surah"
]
},
{
"required": [
"ayah"
]
}
]
},
"required": [
"page"
]
},
{
"not": {
"required": [
"page"
]
},
"required": [
"surah",
"ayah"
]
}
],
"properties": {
"ayah": {
"type": "integer",
"maximum": 286,
"minimum": 1
},
"page": {
"type": "integer",
"maximum": 604,
"minimum": 1
},
"surah": {
"type": "integer",
"maximum": 114,
"minimum": 1
},
"response_profile": {
"enum": [
"compact",
"default",
"full"
],
"type": "string",
"default": "default",
"description": "Per-heading introduction limits: compact 1000 characters per language, default 6000, full all stored text. Titles and ranges are always preserved."
}
},
"additionalProperties": false
}lookup_quran_page output schema
{
"type": "object",
"oneOf": [
{
"required": [
"page",
"url",
"mushaf",
"previous_page",
"next_page",
"ranges",
"ayahs",
"page_boundary_note",
"summary",
"headings"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"url": {
"type": "string"
},
"page": {
"type": "integer"
},
"ayahs": {
"type": "array",
"items": {
"type": "object",
"required": [
"reference",
"surah",
"ayah",
"first_word",
"last_word"
],
"properties": {
"ayah": {
"type": "integer"
},
"surah": {
"type": "integer"
},
"last_word": {
"type": [
"integer",
"null"
]
},
"reference": {
"type": "string"
},
"first_word": {
"type": [
"integer",
"null"
]
}
},
"additionalProperties": false
}
},
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
},
"mushaf": {
"type": "object",
"required": [
"name",
"total_pages",
"lines_per_page"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"total_pages": {
"type": "integer"
},
"lines_per_page": {
"type": "integer"
}
},
"additionalProperties": false
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"required": [
"surah",
"ayah_from",
"ayah_to"
],
"properties": {
"surah": {
"type": "integer"
},
"ayah_to": {
"type": "integer"
},
"ayah_from": {
"type": "integer"
}
},
"additionalProperties": false
}
},
"summary": {
"type": "object",
"required": [
"kind",
"text_english",
"text_arabic",
"note"
],
"properties": {
"kind": {
"enum": [
"stored_heading_outline"
],
"type": "string"
},
"note": {
"type": "string"
},
"text_arabic": {
"type": [
"string",
"null"
]
},
"text_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"headings": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"level",
"surah",
"section",
"subsection",
"title_arabic",
"title_english",
"introduction_arabic",
"introduction_english",
"introduction_scope",
"truncated",
"ayah_from",
"ayah_to",
"reference",
"url"
],
"properties": {
"key": {
"type": "string"
},
"url": {
"type": "string"
},
"level": {
"enum": [
2,
3
],
"type": "integer"
},
"surah": {
"type": "integer"
},
"ayah_to": {
"type": "integer"
},
"section": {
"type": "integer"
},
"ayah_from": {
"type": "integer"
},
"reference": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"subsection": {
"type": [
"integer",
"null"
]
},
"title_arabic": {
"type": [
"string",
"null"
]
},
"title_english": {
"type": [
"string",
"null"
]
},
"introduction_scope": {
"type": "string"
},
"introduction_arabic": {
"type": [
"string",
"null"
]
},
"introduction_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"next_page": {
"type": [
"integer",
"null"
]
},
"previous_page": {
"type": [
"integer",
"null"
]
},
"page_boundary_note": {
"type": "string"
}
},
"additionalProperties": false
}lookup_quran_page annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}list_quran_sections — List Quran sections
Advertised read-onlyOpen-world
List a surah’s passage (level 2) and subsection (level 3) headings in hierarchy order, with exact section identities, Arabic/English titles, stored introductions, ayah ranges, and URLs. These editorial headings and introductions are distinct from Quran text. Follow next_offset for more results.
list_quran_sections input schema
{
"type": "object",
"required": [
"surah"
],
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 100,
"minimum": 1
},
"surah": {
"type": "integer",
"maximum": 114,
"minimum": 1
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0
},
"response_profile": {
"enum": [
"compact",
"default",
"full"
],
"type": "string",
"default": "default",
"description": "Per-heading introduction limits: compact 1000 characters per language, default 6000, full all stored text. Titles and ranges are always preserved."
}
},
"additionalProperties": false
}list_quran_sections output schema
{
"type": "object",
"oneOf": [
{
"required": [
"surah",
"url",
"total",
"offset",
"has_more",
"next_offset",
"headings"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"url": {
"type": "string"
},
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
},
"surah": {
"type": "integer"
},
"total": {
"type": "integer"
},
"offset": {
"type": "integer"
},
"has_more": {
"type": "boolean"
},
"headings": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"level",
"surah",
"section",
"subsection",
"title_arabic",
"title_english",
"introduction_arabic",
"introduction_english",
"introduction_scope",
"truncated",
"ayah_from",
"ayah_to",
"reference",
"url"
],
"properties": {
"key": {
"type": "string"
},
"url": {
"type": "string"
},
"level": {
"enum": [
2,
3
],
"type": "integer"
},
"surah": {
"type": "integer"
},
"ayah_to": {
"type": "integer"
},
"section": {
"type": "integer"
},
"ayah_from": {
"type": "integer"
},
"reference": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"subsection": {
"type": [
"integer",
"null"
]
},
"title_arabic": {
"type": [
"string",
"null"
]
},
"title_english": {
"type": [
"string",
"null"
]
},
"introduction_scope": {
"type": "string"
},
"introduction_arabic": {
"type": [
"string",
"null"
]
},
"introduction_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"next_offset": {
"type": [
"integer",
"null"
]
}
},
"additionalProperties": false
}list_quran_sections annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}lookup_quran_passage — Look up Quran passage
Advertised read-onlyOpen-world
Get an exact Quran passage by surah and section number, optionally subsection; or find the passage containing a surah and ayah. Returns stored bilingual headings/introductions, exact ayah ranges, parent/subsection relationships, and Mushaf links. A section number is an editorial passage identifier, not an ayah number. Use list_quran_sections to discover section IDs.
lookup_quran_passage input schema
{
"type": "object",
"oneOf": [
{
"not": {
"required": [
"ayah"
]
},
"required": [
"section"
]
},
{
"not": {
"anyOf": [
{
"required": [
"section"
]
},
{
"required": [
"subsection"
]
}
]
},
"required": [
"ayah"
]
}
],
"required": [
"surah"
],
"properties": {
"ayah": {
"type": "integer",
"maximum": 286,
"minimum": 0,
"description": "Ayah 0 is valid only in surah 1."
},
"surah": {
"type": "integer",
"maximum": 114,
"minimum": 1
},
"section": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"subsection": {
"type": "integer",
"maximum": 1000,
"minimum": 1
},
"response_profile": {
"enum": [
"compact",
"default",
"full"
],
"type": "string",
"default": "default",
"description": "Per-heading introduction limits: compact 1000 characters per language, default 6000, full all stored text. Titles and ranges are always preserved."
}
},
"additionalProperties": false
}lookup_quran_passage output schema
{
"type": "object",
"oneOf": [
{
"required": [
"passage",
"parent",
"subsections",
"first_page",
"last_page",
"mushaf_url"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
},
"parent": {
"anyOf": [
{
"type": "object",
"required": [
"key",
"level",
"surah",
"section",
"subsection",
"title_arabic",
"title_english",
"introduction_arabic",
"introduction_english",
"introduction_scope",
"truncated",
"ayah_from",
"ayah_to",
"reference",
"url"
],
"properties": {
"key": {
"type": "string"
},
"url": {
"type": "string"
},
"level": {
"enum": [
2,
3
],
"type": "integer"
},
"surah": {
"type": "integer"
},
"ayah_to": {
"type": "integer"
},
"section": {
"type": "integer"
},
"ayah_from": {
"type": "integer"
},
"reference": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"subsection": {
"type": [
"integer",
"null"
]
},
"title_arabic": {
"type": [
"string",
"null"
]
},
"title_english": {
"type": [
"string",
"null"
]
},
"introduction_scope": {
"type": "string"
},
"introduction_arabic": {
"type": [
"string",
"null"
]
},
"introduction_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"passage": {
"type": "object",
"required": [
"key",
"level",
"surah",
"section",
"subsection",
"title_arabic",
"title_english",
"introduction_arabic",
"introduction_english",
"introduction_scope",
"truncated",
"ayah_from",
"ayah_to",
"reference",
"url"
],
"properties": {
"key": {
"type": "string"
},
"url": {
"type": "string"
},
"level": {
"enum": [
2,
3
],
"type": "integer"
},
"surah": {
"type": "integer"
},
"ayah_to": {
"type": "integer"
},
"section": {
"type": "integer"
},
"ayah_from": {
"type": "integer"
},
"reference": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"subsection": {
"type": [
"integer",
"null"
]
},
"title_arabic": {
"type": [
"string",
"null"
]
},
"title_english": {
"type": [
"string",
"null"
]
},
"introduction_scope": {
"type": "string"
},
"introduction_arabic": {
"type": [
"string",
"null"
]
},
"introduction_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"last_page": {
"type": [
"integer",
"null"
]
},
"first_page": {
"type": [
"integer",
"null"
]
},
"mushaf_url": {
"type": [
"string",
"null"
]
},
"subsections": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"level",
"surah",
"section",
"subsection",
"title_arabic",
"title_english",
"introduction_arabic",
"introduction_english",
"introduction_scope",
"truncated",
"ayah_from",
"ayah_to",
"reference",
"url"
],
"properties": {
"key": {
"type": "string"
},
"url": {
"type": "string"
},
"level": {
"enum": [
2,
3
],
"type": "integer"
},
"surah": {
"type": "integer"
},
"ayah_to": {
"type": "integer"
},
"section": {
"type": "integer"
},
"ayah_from": {
"type": "integer"
},
"reference": {
"type": "string"
},
"truncated": {
"type": "boolean"
},
"subsection": {
"type": [
"integer",
"null"
]
},
"title_arabic": {
"type": [
"string",
"null"
]
},
"title_english": {
"type": [
"string",
"null"
]
},
"introduction_scope": {
"type": "string"
},
"introduction_arabic": {
"type": [
"string",
"null"
]
},
"introduction_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}lookup_quran_passage annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}list_quran_reciters — List Quran reciters
Advertised read-onlyOpen-world
List available Quran audio reciters and their aliases. Use this to resolve a requested reciter. Juhani is the default.
list_quran_reciters input schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}list_quran_reciters output schema
{
"type": "object",
"oneOf": [
{
"required": [
"default_reciter",
"reciters"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
},
"reciters": {
"type": "array",
"items": {
"type": "object",
"required": [
"alias",
"name"
],
"properties": {
"name": {
"type": "string"
},
"alias": {
"type": "string"
}
},
"additionalProperties": false
}
},
"default_reciter": {
"type": "string"
}
},
"additionalProperties": false
}list_quran_reciters annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_quran_audio — Get Quran passage audio
Advertised read-onlyOpen-world
Get an audio URL and exact ayah timing segments for a Quran passage by a selected reciter (default: Juhani). Returns playback data, not a command that starts playback. Use surah, ayah_from, and optionally ayah_to for an inclusive range. For portions spanning surahs, call once per surah and play in order. Use list_quran_reciters for available names and aliases. Clients must seek to start_ms and stop at end_ms; the URL points to the full surah.
get_quran_audio input schema
{
"type": "object",
"required": [
"surah",
"ayah_from"
],
"properties": {
"surah": {
"type": "integer",
"maximum": 114,
"minimum": 1
},
"ayah_to": {
"type": "integer",
"maximum": 286,
"minimum": 1,
"description": "Inclusive last ayah; defaults to ayah_from. For a whole surah, specify its first and last ayah."
},
"reciter": {
"type": "string",
"default": "juhani",
"minLength": 1,
"description": "Reciter alias or exact catalog name. Defaults to Juhani."
},
"ayah_from": {
"type": "integer",
"maximum": 286,
"minimum": 1
}
},
"additionalProperties": false
}get_quran_audio output schema
{
"type": "object",
"oneOf": [
{
"required": [
"reciter",
"reference",
"audio_url",
"playback_url",
"start_ms",
"end_ms",
"segments"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
},
"end_ms": {
"type": "integer",
"minimum": 1
},
"reciter": {
"type": "object",
"required": [
"alias",
"name"
],
"properties": {
"name": {
"type": "string"
},
"alias": {
"type": "string"
}
},
"additionalProperties": false
},
"segments": {
"type": "array",
"items": {
"type": "object",
"required": [
"reference",
"start_ms",
"end_ms"
],
"properties": {
"end_ms": {
"type": "integer",
"minimum": 1
},
"start_ms": {
"type": "integer",
"minimum": 0
},
"reference": {
"type": "string"
}
},
"additionalProperties": false
},
"minItems": 1
},
"start_ms": {
"type": "integer",
"minimum": 0
},
"audio_url": {
"type": "string",
"description": "Full surah audio file; use the supplied timing boundaries for the requested passage."
},
"reference": {
"type": "string"
},
"playback_url": {
"type": "string",
"description": "Audio URL with a temporal media fragment in seconds. Client support varies."
}
},
"additionalProperties": false
}get_quran_audio annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}lookup_quran_ayah — Look up Quran ayah
Advertised read-onlyOpen-world
Retrieve the exact Arabic text, English translation, headings, and canonical URL for one Quran ayah. For explanations of its meaning, use research_quran_ayah to consult major available tafsirs and research its concepts in hadith and shuruh before synthesizing.
lookup_quran_ayah input schema
{
"type": "object",
"required": [
"surah",
"ayah"
],
"properties": {
"ayah": {
"type": "integer",
"minimum": 0,
"description": "Ayah number. Ayah 0 is valid only for Surah 1."
},
"surah": {
"type": "integer",
"maximum": 114,
"minimum": 1,
"description": "Surah number, 1 through 114."
}
},
"additionalProperties": false
}lookup_quran_ayah output schema
{
"type": "object",
"oneOf": [
{
"required": [
"ayah"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"ayah": {
"type": "object",
"required": [
"id",
"reference",
"url",
"book",
"number",
"chapter_number",
"headings",
"english",
"arabic",
"bilingual",
"text",
"text_arabic",
"text_english",
"truncated"
],
"properties": {
"id": {
"type": [
"integer",
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
],
"description": "Canonical public URL for the record."
},
"book": {
"type": "object",
"required": [
"alias",
"name_english",
"name_arabic",
"short_name_english",
"short_name_arabic"
],
"properties": {
"alias": {
"type": [
"string",
"null"
]
},
"name_arabic": {
"type": [
"string",
"null"
]
},
"name_english": {
"type": [
"string",
"null"
]
},
"short_name_arabic": {
"type": [
"string",
"null"
]
},
"short_name_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"text": {
"type": [
"string",
"null"
],
"description": "Combined English and Arabic text when either is present."
},
"grade": {
"type": "object",
"required": [
"english",
"arabic",
"grader_english",
"grader_arabic"
],
"properties": {
"arabic": {
"type": [
"string",
"null"
]
},
"english": {
"type": [
"string",
"null"
]
},
"grader_arabic": {
"type": [
"string",
"null"
]
},
"grader_english": {
"type": [
"string",
"null"
]
}
},
"description": "Hadith grading and attribution. Absent for Quran records.",
"additionalProperties": false
},
"arabic": {
"type": "object",
"required": [
"title",
"chain",
"body",
"footnote"
],
"properties": {
"body": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"footnote": {
"type": [
"string",
"null"
]
}
},
"description": "The separately addressable fields for one language.",
"additionalProperties": false
},
"number": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"english": {
"type": "object",
"required": [
"title",
"chain",
"body",
"footnote"
],
"properties": {
"body": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"footnote": {
"type": [
"string",
"null"
]
}
},
"description": "The separately addressable fields for one language.",
"additionalProperties": false
},
"headings": {
"type": "array",
"items": {
"type": "object",
"required": [
"number",
"english",
"arabic"
],
"properties": {
"arabic": {
"type": [
"string",
"null"
]
},
"number": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"metadata": {
"type": "object",
"properties": {
"sharh": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Attached commentary identities in compact; bounded/full commentary text in other profiles. research_inventory.commentaries always lists every attached entry."
},
"grades": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "All stored grader opinions, including the primary grade when supplied by the source."
},
"narrators": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Complete attached narrator list, with reliability and death_text (stored death year/date description) when available."
},
"related_reports": {
"type": "array",
"items": {
"type": "string"
},
"description": "Deduplicated collection:number references for similar and parallel reports; no narration text."
}
},
"description": "Research metadata in every detail profile; default/full additionally include source provenance and commentary text.",
"additionalProperties": true
},
"bilingual": {
"type": "boolean",
"description": "Whether both Arabic and English text are present."
},
"reference": {
"type": [
"string",
"null"
],
"description": "Canonical HadithDB reference."
},
"truncated": {
"type": "boolean",
"description": "Whether one or more text fields were shortened for the selected response profile."
},
"text_arabic": {
"type": [
"string",
"null"
],
"description": "Full Arabic text."
},
"text_english": {
"type": [
"string",
"null"
],
"description": "Full English text."
},
"chapter_number": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"research_inventory": {
"type": "object",
"required": [
"commentary_status",
"commentary_entry_count",
"commentary_work_count",
"commentaries",
"related_reports",
"commentary_text_included",
"next_step"
],
"properties": {
"next_step": {
"type": "string"
},
"commentaries": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"source",
"hadith_reference"
],
"properties": {
"id": {
"type": [
"integer",
"null"
]
},
"source": {
"type": "object",
"required": [
"id",
"alias",
"title_arabic",
"title_english",
"author_arabic",
"author_english"
],
"properties": {
"id": {
"type": [
"integer",
"null"
]
},
"alias": {
"type": [
"string",
"null"
]
},
"title_arabic": {
"type": [
"string",
"null"
]
},
"author_arabic": {
"type": [
"string",
"null"
]
},
"title_english": {
"type": [
"string",
"null"
]
},
"author_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"hadith_reference": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"related_reports": {
"type": "array",
"items": {
"type": "object",
"required": [
"reference",
"relationship",
"label"
],
"properties": {
"label": {
"type": [
"string",
"null"
]
},
"reference": {
"type": "string"
},
"relationship": {
"type": "string"
}
},
"additionalProperties": false
}
},
"commentary_status": {
"enum": [
"found",
"searched_no_match",
"unavailable"
],
"type": "string"
},
"commentary_work_count": {
"type": "integer"
},
"commentary_entry_count": {
"type": "integer"
},
"commentary_text_included": {
"type": "boolean"
}
},
"description": "Available commentary entries and verified internal report links, including in compact responses. Missing attached commentary does not imply no scholarly discussion exists.",
"additionalProperties": false
},
"translation_matches": {
"type": "array",
"items": {
"type": "object",
"required": [
"source_alias",
"source_name_english",
"source_name_arabic",
"language",
"text"
],
"properties": {
"text": {
"type": "string"
},
"language": {
"type": [
"string",
"null"
]
},
"source_alias": {
"type": [
"string",
"null"
]
},
"source_name_arabic": {
"type": [
"string",
"null"
]
},
"source_name_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"description": "Distinct translation matches merged under the canonical Quran ayah."
}
},
"description": "A normalized Quran, hadith, sirah, or history record.",
"additionalProperties": false
},
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
}
},
"additionalProperties": false
}lookup_quran_ayah annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}search_quran — Search Quran
Advertised read-onlyOpen-world
Search Quran Arabic text and English translations by words or phrases. Use lookup_quran_ayah for an exact reference.
search_quran input schema
{
"type": "object",
"required": [
"query"
],
"properties": {
"sort": {
"enum": [
"relevance",
"canonical"
],
"type": "string",
"default": "relevance"
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"minLength": 1,
"description": "Words or phrase to search for."
},
"cursor": {
"type": "string",
"minLength": 1,
"description": "Opaque cursor returned by the previous page. Do not modify it."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Deprecated numeric pagination offset. Prefer cursor."
}
},
"additionalProperties": false
}search_quran output schema
{
"type": "object",
"oneOf": [
{
"required": [
"query",
"offset",
"pagination",
"results"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
},
"query": {
"type": "string"
},
"offset": {
"type": "integer",
"minimum": 0
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"reference",
"url",
"book",
"number",
"chapter_number",
"headings",
"english",
"arabic",
"bilingual",
"text",
"text_arabic",
"text_english",
"truncated"
],
"properties": {
"id": {
"type": [
"integer",
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
],
"description": "Canonical public URL for the record."
},
"book": {
"type": "object",
"required": [
"alias",
"name_english",
"name_arabic",
"short_name_english",
"short_name_arabic"
],
"properties": {
"alias": {
"type": [
"string",
"null"
]
},
"name_arabic": {
"type": [
"string",
"null"
]
},
"name_english": {
"type": [
"string",
"null"
]
},
"short_name_arabic": {
"type": [
"string",
"null"
]
},
"short_name_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"text": {
"type": [
"string",
"null"
],
"description": "Combined English and Arabic text when either is present."
},
"grade": {
"type": "object",
"required": [
"english",
"arabic",
"grader_english",
"grader_arabic"
],
"properties": {
"arabic": {
"type": [
"string",
"null"
]
},
"english": {
"type": [
"string",
"null"
]
},
"grader_arabic": {
"type": [
"string",
"null"
]
},
"grader_english": {
"type": [
"string",
"null"
]
}
},
"description": "Hadith grading and attribution. Absent for Quran records.",
"additionalProperties": false
},
"arabic": {
"type": "object",
"required": [
"title",
"chain",
"body",
"footnote"
],
"properties": {
"body": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"footnote": {
"type": [
"string",
"null"
]
}
},
"description": "The separately addressable fields for one language.",
"additionalProperties": false
},
"number": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"english": {
"type": "object",
"required": [
"title",
"chain",
"body",
"footnote"
],
"properties": {
"body": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"footnote": {
"type": [
"string",
"null"
]
}
},
"description": "The separately addressable fields for one language.",
"additionalProperties": false
},
"headings": {
"type": "array",
"items": {
"type": "object",
"required": [
"number",
"english",
"arabic"
],
"properties": {
"arabic": {
"type": [
"string",
"null"
]
},
"number": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"metadata": {
"type": "object",
"properties": {
"sharh": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Attached commentary identities in compact; bounded/full commentary text in other profiles. research_inventory.commentaries always lists every attached entry."
},
"grades": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "All stored grader opinions, including the primary grade when supplied by the source."
},
"narrators": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Complete attached narrator list, with reliability and death_text (stored death year/date description) when available."
},
"related_reports": {
"type": "array",
"items": {
"type": "string"
},
"description": "Deduplicated collection:number references for similar and parallel reports; no narration text."
}
},
"description": "Research metadata in every detail profile; default/full additionally include source provenance and commentary text.",
"additionalProperties": true
},
"bilingual": {
"type": "boolean",
"description": "Whether both Arabic and English text are present."
},
"reference": {
"type": [
"string",
"null"
],
"description": "Canonical HadithDB reference."
},
"truncated": {
"type": "boolean",
"description": "Whether one or more text fields were shortened for the selected response profile."
},
"text_arabic": {
"type": [
"string",
"null"
],
"description": "Full Arabic text."
},
"text_english": {
"type": [
"string",
"null"
],
"description": "Full English text."
},
"chapter_number": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"research_inventory": {
"type": "object",
"required": [
"commentary_status",
"commentary_entry_count",
"commentary_work_count",
"commentaries",
"related_reports",
"commentary_text_included",
"next_step"
],
"properties": {
"next_step": {
"type": "string"
},
"commentaries": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"source",
"hadith_reference"
],
"properties": {
"id": {
"type": [
"integer",
"null"
]
},
"source": {
"type": "object",
"required": [
"id",
"alias",
"title_arabic",
"title_english",
"author_arabic",
"author_english"
],
"properties": {
"id": {
"type": [
"integer",
"null"
]
},
"alias": {
"type": [
"string",
"null"
]
},
"title_arabic": {
"type": [
"string",
"null"
]
},
"author_arabic": {
"type": [
"string",
"null"
]
},
"title_english": {
"type": [
"string",
"null"
]
},
"author_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"hadith_reference": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"related_reports": {
"type": "array",
"items": {
"type": "object",
"required": [
"reference",
"relationship",
"label"
],
"properties": {
"label": {
"type": [
"string",
"null"
]
},
"reference": {
"type": "string"
},
"relationship": {
"type": "string"
}
},
"additionalProperties": false
}
},
"commentary_status": {
"enum": [
"found",
"searched_no_match",
"unavailable"
],
"type": "string"
},
"commentary_work_count": {
"type": "integer"
},
"commentary_entry_count": {
"type": "integer"
},
"commentary_text_included": {
"type": "boolean"
}
},
"description": "Available commentary entries and verified internal report links, including in compact responses. Missing attached commentary does not imply no scholarly discussion exists.",
"additionalProperties": false
},
"translation_matches": {
"type": "array",
"items": {
"type": "object",
"required": [
"source_alias",
"source_name_english",
"source_name_arabic",
"language",
"text"
],
"properties": {
"text": {
"type": "string"
},
"language": {
"type": [
"string",
"null"
]
},
"source_alias": {
"type": [
"string",
"null"
]
},
"source_name_arabic": {
"type": [
"string",
"null"
]
},
"source_name_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"description": "Distinct translation matches merged under the canonical Quran ayah."
}
},
"description": "A normalized Quran, hadith, sirah, or history record.",
"additionalProperties": false
}
},
"pagination": {
"type": "object",
"required": [
"limit",
"returned",
"offset",
"total_available",
"total_is_exact",
"has_more",
"next_cursor"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"offset": {
"type": "integer",
"minimum": 0
},
"has_more": {
"type": "boolean"
},
"returned": {
"type": "integer",
"minimum": 0
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"total_is_exact": {
"type": "boolean"
},
"total_available": {
"type": [
"integer",
"null"
],
"minimum": 0
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}search_quran annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}list_tafsirs — List tafsirs
Advertised read-onlyOpen-world
Find available HadithDB tafsir sources and aliases. Use this to resolve an author or title before a tafsir lookup.
list_tafsirs input schema
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 25,
"maximum": 100,
"minimum": 1
},
"query": {
"type": "string",
"description": "Optional author, title, language, or alias filter."
},
"cursor": {
"type": "string",
"minLength": 1,
"description": "Opaque cursor returned by the previous page. Do not modify it."
}
},
"additionalProperties": false
}list_tafsirs output schema
{
"type": "object",
"oneOf": [
{
"required": [
"query",
"total",
"has_more",
"next_cursor",
"tafsirs"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
},
"query": {
"type": [
"string",
"null"
]
},
"total": {
"type": "integer",
"minimum": 0
},
"tafsirs": {
"type": "array",
"items": {
"type": "object",
"required": [
"alias",
"name_english",
"name_arabic",
"short_name_english",
"short_name_arabic",
"author_english",
"author_arabic",
"available",
"languages"
],
"properties": {
"alias": {
"type": "string"
},
"available": {
"type": "boolean"
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
},
"name_arabic": {
"type": [
"string",
"null"
]
},
"name_english": {
"type": [
"string",
"null"
]
},
"author_arabic": {
"type": [
"string",
"null"
]
},
"author_english": {
"type": [
"string",
"null"
]
},
"short_name_arabic": {
"type": [
"string",
"null"
]
},
"short_name_english": {
"type": [
"string",
"null"
]
}
},
"description": "A normalized local tafsir source.",
"additionalProperties": false
}
},
"has_more": {
"type": "boolean"
},
"next_cursor": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}list_tafsirs annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}lookup_tafsir — Look up tafsir
Advertised read-onlyOpen-world
Retrieve commentary from a named HadithDB tafsir source for one Quran ayah.
lookup_tafsir input schema
{
"type": "object",
"required": [
"tafsir",
"surah",
"ayah"
],
"properties": {
"ayah": {
"type": "integer",
"minimum": 0
},
"surah": {
"type": "integer",
"maximum": 114,
"minimum": 1
},
"tafsir": {
"type": "string",
"minLength": 1,
"description": "Alias, author, short name, or title, such as ibn-kathir."
},
"language": {
"enum": [
"ar",
"en"
],
"type": "string",
"description": "Preferred output language when available."
},
"max_chars": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Optional explicit character cap per language, overriding the selected response profile."
},
"response_profile": {
"enum": [
"compact",
"default",
"full"
],
"type": "string",
"default": "default",
"description": "Controls response size. Compact shortens long commentary, default balances context and size, and full returns all stored text."
}
},
"additionalProperties": false
}lookup_tafsir output schema
{
"type": "object",
"oneOf": [
{
"required": [
"source",
"reference",
"url",
"response_profile",
"availability",
"commentary"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"url": {
"type": "string"
},
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
},
"source": {
"type": "object",
"required": [
"alias",
"name_english",
"name_arabic",
"short_name_english",
"short_name_arabic",
"author_english",
"author_arabic",
"available",
"languages"
],
"properties": {
"alias": {
"type": "string"
},
"available": {
"type": "boolean"
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
},
"name_arabic": {
"type": [
"string",
"null"
]
},
"name_english": {
"type": [
"string",
"null"
]
},
"author_arabic": {
"type": [
"string",
"null"
]
},
"author_english": {
"type": [
"string",
"null"
]
},
"short_name_arabic": {
"type": [
"string",
"null"
]
},
"short_name_english": {
"type": [
"string",
"null"
]
}
},
"description": "A normalized local tafsir source.",
"additionalProperties": false
},
"reference": {
"type": "string"
},
"commentary": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"ayah_from",
"ayah_to",
"language",
"bilingual",
"text",
"text_arabic",
"text_english",
"truncated"
],
"properties": {
"id": {
"type": [
"integer",
"string",
"null"
]
},
"text": {
"type": [
"string",
"null"
],
"description": "Combined English and Arabic text when either is present."
},
"ayah_to": {
"type": [
"integer",
"number",
"string"
]
},
"language": {
"type": [
"string",
"null"
]
},
"ayah_from": {
"type": [
"integer",
"number",
"string"
]
},
"bilingual": {
"type": "boolean",
"description": "Whether both Arabic and English text are present."
},
"truncated": {
"type": "boolean",
"description": "Whether one or more text fields were shortened for the selected response profile."
},
"text_arabic": {
"type": [
"string",
"null"
],
"description": "Full Arabic text."
},
"text_english": {
"type": [
"string",
"null"
],
"description": "Full English text."
}
},
"additionalProperties": false
}
},
"availability": {
"type": "object",
"required": [
"requested_language",
"resolved_language",
"fallback_used",
"available_languages",
"has_arabic",
"has_english"
],
"properties": {
"has_arabic": {
"type": "boolean"
},
"has_english": {
"type": "boolean"
},
"fallback_used": {
"type": "boolean"
},
"resolved_language": {
"type": [
"string",
"null"
]
},
"requested_language": {
"type": [
"string",
"null"
]
},
"available_languages": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"response_profile": {
"enum": [
"compact",
"default",
"full"
],
"type": "string"
}
},
"additionalProperties": false
}lookup_tafsir annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}search_tafsir — Search tafsir
Advertised read-onlyOpen-world
Search HadithDB tafsir commentary, optionally restricting results to one named source.
search_tafsir input schema
{
"type": "object",
"required": [
"query"
],
"properties": {
"sort": {
"enum": [
"relevance",
"canonical"
],
"type": "string",
"default": "relevance"
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"minLength": 1,
"description": "Words or phrase to search for."
},
"cursor": {
"type": "string",
"minLength": 1,
"description": "Opaque cursor returned by the previous page. Do not modify it."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Deprecated numeric pagination offset. Prefer cursor."
},
"tafsir": {
"type": "string",
"minLength": 1,
"description": "Optional tafsir alias, author, short name, or title."
}
},
"additionalProperties": false
}search_tafsir output schema
{
"type": "object",
"oneOf": [
{
"required": [
"query",
"offset",
"pagination",
"source",
"results"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
},
"query": {
"type": "string"
},
"offset": {
"type": "integer",
"minimum": 0
},
"source": {
"anyOf": [
{
"type": "object",
"required": [
"alias",
"name_english",
"name_arabic",
"short_name_english",
"short_name_arabic",
"author_english",
"author_arabic",
"available",
"languages"
],
"properties": {
"alias": {
"type": "string"
},
"available": {
"type": "boolean"
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
},
"name_arabic": {
"type": [
"string",
"null"
]
},
"name_english": {
"type": [
"string",
"null"
]
},
"author_arabic": {
"type": [
"string",
"null"
]
},
"author_english": {
"type": [
"string",
"null"
]
},
"short_name_arabic": {
"type": [
"string",
"null"
]
},
"short_name_english": {
"type": [
"string",
"null"
]
}
},
"description": "A normalized local tafsir source.",
"additionalProperties": false
},
{
"type": "null"
}
]
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"source",
"reference",
"surah",
"ayah_from",
"ayah_to",
"bilingual",
"text",
"text_arabic",
"text_english",
"truncated",
"url"
],
"properties": {
"id": {
"type": [
"integer",
"string",
"null"
]
},
"url": {
"type": "string"
},
"text": {
"type": [
"string",
"null"
],
"description": "Combined English and Arabic text when either is present."
},
"surah": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"source": {
"type": "object",
"required": [
"alias",
"name_english",
"name_arabic",
"author_english",
"author_arabic",
"languages"
],
"properties": {
"alias": {
"type": [
"string",
"null"
]
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
},
"name_arabic": {
"type": [
"string",
"null"
]
},
"name_english": {
"type": [
"string",
"null"
]
},
"author_arabic": {
"type": [
"string",
"null"
]
},
"author_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"ayah_to": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"ayah_from": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"bilingual": {
"type": "boolean",
"description": "Whether both Arabic and English text are present."
},
"reference": {
"type": "string"
},
"truncated": {
"type": "boolean",
"description": "Whether one or more text fields were shortened for the selected response profile."
},
"text_arabic": {
"type": [
"string",
"null"
],
"description": "Full Arabic text."
},
"text_english": {
"type": [
"string",
"null"
],
"description": "Full English text."
}
},
"additionalProperties": false
}
},
"pagination": {
"type": "object",
"required": [
"limit",
"returned",
"offset",
"total_available",
"total_is_exact",
"has_more",
"next_cursor"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"offset": {
"type": "integer",
"minimum": 0
},
"has_more": {
"type": "boolean"
},
"returned": {
"type": "integer",
"minimum": 0
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"total_is_exact": {
"type": "boolean"
},
"total_available": {
"type": [
"integer",
"null"
],
"minimum": 0
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}search_tafsir annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}search_hadith — Search hadith
Advertised read-onlyOpen-world
Search Arabic or English hadith, sirah, and history text, optionally within selected book aliases or virtual book groups. Use the sirah or history scope to search every book whose type is sirah or history.
search_hadith input schema
{
"type": "object",
"required": [
"query"
],
"properties": {
"books": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 20,
"description": "Optional HadithDB book aliases or groups such as sahihayn, sixbooks, ninebooks, sirah, or history. Either sirah or history searches all books of both historical types."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"minLength": 1,
"description": "Words or phrase to search for."
},
"cursor": {
"type": "string",
"minLength": 1,
"description": "Opaque cursor returned by the previous page. Do not modify it."
},
"offset": {
"type": "integer",
"default": 0,
"minimum": 0,
"description": "Deprecated numeric pagination offset. Prefer cursor."
}
},
"additionalProperties": false
}search_hadith output schema
{
"type": "object",
"oneOf": [
{
"required": [
"query",
"offset",
"pagination",
"books",
"results"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"books": {
"type": "array",
"items": {
"type": "string"
}
},
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
},
"query": {
"type": "string"
},
"offset": {
"type": "integer",
"minimum": 0
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"reference",
"url",
"book",
"number",
"chapter_number",
"headings",
"english",
"arabic",
"bilingual",
"text",
"text_arabic",
"text_english",
"truncated"
],
"properties": {
"id": {
"type": [
"integer",
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
],
"description": "Canonical public URL for the record."
},
"book": {
"type": "object",
"required": [
"alias",
"name_english",
"name_arabic",
"short_name_english",
"short_name_arabic"
],
"properties": {
"alias": {
"type": [
"string",
"null"
]
},
"name_arabic": {
"type": [
"string",
"null"
]
},
"name_english": {
"type": [
"string",
"null"
]
},
"short_name_arabic": {
"type": [
"string",
"null"
]
},
"short_name_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"text": {
"type": [
"string",
"null"
],
"description": "Combined English and Arabic text when either is present."
},
"grade": {
"type": "object",
"required": [
"english",
"arabic",
"grader_english",
"grader_arabic"
],
"properties": {
"arabic": {
"type": [
"string",
"null"
]
},
"english": {
"type": [
"string",
"null"
]
},
"grader_arabic": {
"type": [
"string",
"null"
]
},
"grader_english": {
"type": [
"string",
"null"
]
}
},
"description": "Hadith grading and attribution. Absent for Quran records.",
"additionalProperties": false
},
"arabic": {
"type": "object",
"required": [
"title",
"chain",
"body",
"footnote"
],
"properties": {
"body": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"footnote": {
"type": [
"string",
"null"
]
}
},
"description": "The separately addressable fields for one language.",
"additionalProperties": false
},
"number": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"english": {
"type": "object",
"required": [
"title",
"chain",
"body",
"footnote"
],
"properties": {
"body": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"footnote": {
"type": [
"string",
"null"
]
}
},
"description": "The separately addressable fields for one language.",
"additionalProperties": false
},
"headings": {
"type": "array",
"items": {
"type": "object",
"required": [
"number",
"english",
"arabic"
],
"properties": {
"arabic": {
"type": [
"string",
"null"
]
},
"number": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"metadata": {
"type": "object",
"properties": {
"sharh": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Attached commentary identities in compact; bounded/full commentary text in other profiles. research_inventory.commentaries always lists every attached entry."
},
"grades": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "All stored grader opinions, including the primary grade when supplied by the source."
},
"narrators": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Complete attached narrator list, with reliability and death_text (stored death year/date description) when available."
},
"related_reports": {
"type": "array",
"items": {
"type": "string"
},
"description": "Deduplicated collection:number references for similar and parallel reports; no narration text."
}
},
"description": "Research metadata in every detail profile; default/full additionally include source provenance and commentary text.",
"additionalProperties": true
},
"bilingual": {
"type": "boolean",
"description": "Whether both Arabic and English text are present."
},
"reference": {
"type": [
"string",
"null"
],
"description": "Canonical HadithDB reference."
},
"truncated": {
"type": "boolean",
"description": "Whether one or more text fields were shortened for the selected response profile."
},
"text_arabic": {
"type": [
"string",
"null"
],
"description": "Full Arabic text."
},
"text_english": {
"type": [
"string",
"null"
],
"description": "Full English text."
},
"chapter_number": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"research_inventory": {
"type": "object",
"required": [
"commentary_status",
"commentary_entry_count",
"commentary_work_count",
"commentaries",
"related_reports",
"commentary_text_included",
"next_step"
],
"properties": {
"next_step": {
"type": "string"
},
"commentaries": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"source",
"hadith_reference"
],
"properties": {
"id": {
"type": [
"integer",
"null"
]
},
"source": {
"type": "object",
"required": [
"id",
"alias",
"title_arabic",
"title_english",
"author_arabic",
"author_english"
],
"properties": {
"id": {
"type": [
"integer",
"null"
]
},
"alias": {
"type": [
"string",
"null"
]
},
"title_arabic": {
"type": [
"string",
"null"
]
},
"author_arabic": {
"type": [
"string",
"null"
]
},
"title_english": {
"type": [
"string",
"null"
]
},
"author_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"hadith_reference": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"related_reports": {
"type": "array",
"items": {
"type": "object",
"required": [
"reference",
"relationship",
"label"
],
"properties": {
"label": {
"type": [
"string",
"null"
]
},
"reference": {
"type": "string"
},
"relationship": {
"type": "string"
}
},
"additionalProperties": false
}
},
"commentary_status": {
"enum": [
"found",
"searched_no_match",
"unavailable"
],
"type": "string"
},
"commentary_work_count": {
"type": "integer"
},
"commentary_entry_count": {
"type": "integer"
},
"commentary_text_included": {
"type": "boolean"
}
},
"description": "Available commentary entries and verified internal report links, including in compact responses. Missing attached commentary does not imply no scholarly discussion exists.",
"additionalProperties": false
},
"translation_matches": {
"type": "array",
"items": {
"type": "object",
"required": [
"source_alias",
"source_name_english",
"source_name_arabic",
"language",
"text"
],
"properties": {
"text": {
"type": "string"
},
"language": {
"type": [
"string",
"null"
]
},
"source_alias": {
"type": [
"string",
"null"
]
},
"source_name_arabic": {
"type": [
"string",
"null"
]
},
"source_name_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"description": "Distinct translation matches merged under the canonical Quran ayah."
}
},
"description": "A normalized Quran, hadith, sirah, or history record.",
"additionalProperties": false
}
},
"pagination": {
"type": "object",
"required": [
"limit",
"returned",
"offset",
"total_available",
"total_is_exact",
"has_more",
"next_cursor"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"offset": {
"type": "integer",
"minimum": 0
},
"has_more": {
"type": "boolean"
},
"returned": {
"type": "integer",
"minimum": 0
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"total_is_exact": {
"type": "boolean"
},
"total_available": {
"type": [
"integer",
"null"
],
"minimum": 0
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}search_hadith annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}lookup_hadith_detail — Look up hadith detail
Advertised read-onlyOpen-world
Retrieve the core Arabic and English text, chain, headings, grades, and canonical URL for a hadith reference. If the exact numbered reference is absent, tries the unsuffixed number and letter-suffixed variants before reporting not found; returned records retain their actual references. Complete scholarly metadata and provenance are available with response_profile: "full". Every profile includes all stored grader opinions, narrators with reliability and death information, attached commentary identities, and related report references only (no narration text). For worship instructions or scholarly explanations, use research_islamic_topic and the commentary tools before answering.
lookup_hadith_detail input schema
{
"type": "object",
"required": [
"reference"
],
"properties": {
"reference": {
"type": "string",
"minLength": 3,
"description": "Reference such as bukhari:1, muslim:1907, or ahmad:1.6."
},
"response_profile": {
"enum": [
"compact",
"default",
"full"
],
"type": "string",
"default": "compact",
"description": "Compact returns the core record plus research metadata and is the default. Default adds bounded attribution, narrator, grading, reference, and commentary metadata. Full explicitly returns all stored provenance and metadata."
}
},
"additionalProperties": false
}lookup_hadith_detail output schema
{
"type": "object",
"oneOf": [
{
"required": [
"requested_reference",
"canonical_url",
"response_profile",
"records"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"type": "string",
"description": "Error message when the tool could not complete the request."
},
"records": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"reference",
"url",
"book",
"number",
"chapter_number",
"headings",
"english",
"arabic",
"bilingual",
"text",
"text_arabic",
"text_english",
"truncated"
],
"properties": {
"id": {
"type": [
"integer",
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
],
"description": "Canonical public URL for the record."
},
"book": {
"type": "object",
"required": [
"alias",
"name_english",
"name_arabic",
"short_name_english",
"short_name_arabic"
],
"properties": {
"alias": {
"type": [
"string",
"null"
]
},
"name_arabic": {
"type": [
"string",
"null"
]
},
"name_english": {
"type": [
"string",
"null"
]
},
"short_name_arabic": {
"type": [
"string",
"null"
]
},
"short_name_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"text": {
"type": [
"string",
"null"
],
"description": "Combined English and Arabic text when either is present."
},
"grade": {
"type": "object",
"required": [
"english",
"arabic",
"grader_english",
"grader_arabic"
],
"properties": {
"arabic": {
"type": [
"string",
"null"
]
},
"english": {
"type": [
"string",
"null"
]
},
"grader_arabic": {
"type": [
"string",
"null"
]
},
"grader_english": {
"type": [
"string",
"null"
]
}
},
"description": "Hadith grading and attribution. Absent for Quran records.",
"additionalProperties": false
},
"arabic": {
"type": "object",
"required": [
"title",
"chain",
"body",
"footnote"
],
"properties": {
"body": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"footnote": {
"type": [
"string",
"null"
]
}
},
"description": "The separately addressable fields for one language.",
"additionalProperties": false
},
"number": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"english": {
"type": "object",
"required": [
"title",
"chain",
"body",
"footnote"
],
"properties": {
"body": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"title": {
"type": [
"string",
"null"
]
},
"footnote": {
"type": [
"string",
"null"
]
}
},
"description": "The separately addressable fields for one language.",
"additionalProperties": false
},
"headings": {
"type": "array",
"items": {
"type": "object",
"required": [
"number",
"english",
"arabic"
],
"properties": {
"arabic": {
"type": [
"string",
"null"
]
},
"number": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"metadata": {
"type": "object",
"properties": {
"sharh": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Attached commentary identities in compact; bounded/full commentary text in other profiles. research_inventory.commentaries always lists every attached entry."
},
"grades": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "All stored grader opinions, including the primary grade when supplied by the source."
},
"narrators": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
},
"description": "Complete attached narrator list, with reliability and death_text (stored death year/date description) when available."
},
"related_reports": {
"type": "array",
"items": {
"type": "string"
},
"description": "Deduplicated collection:number references for similar and parallel reports; no narration text."
}
},
"description": "Research metadata in every detail profile; default/full additionally include source provenance and commentary text.",
"additionalProperties": true
},
"bilingual": {
"type": "boolean",
"description": "Whether both Arabic and English text are present."
},
"reference": {
"type": [
"string",
"null"
],
"description": "Canonical HadithDB reference."
},
"truncated": {
"type": "boolean",
"description": "Whether one or more text fields were shortened for the selected response profile."
},
"text_arabic": {
"type": [
"string",
"null"
],
"description": "Full Arabic text."
},
"text_english": {
"type": [
"string",
"null"
],
"description": "Full English text."
},
"chapter_number": {
"type": [
"integer",
"number",
"string",
"null"
]
},
"research_inventory": {
"type": "object",
"required": [
"commentary_status",
"commentary_entry_count",
"commentary_work_count",
"commentaries",
"related_reports",
"commentary_text_included",
"next_step"
],
"properties": {
"next_step": {
"type": "string"
},
"commentaries": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"source",
"hadith_reference"
],
"properties": {
"id": {
"type": [
"integer",
"null"
]
},
"source": {
"type": "object",
"required": [
"id",
"alias",
"title_arabic",
"title_english",
"author_arabic",
"author_english"
],
"properties": {
"id": {
"type": [
"integer",
"null"
]
},
"alias": {
"type": [
"string",
"null"
]
},
"title_arabic": {
"type": [
"string",
"null"
]
},
"author_arabic": {
"type": [
"string",
"null"
]
},
"title_english": {
"type": [
"string",
"null"
]
},
"author_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"hadith_reference": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"related_reports": {
"type": "array",
"items": {
"type": "object",
"required": [
"reference",
"relationship",
"label"
],
"properties": {
"label": {
"type": [
"string",
"null"
]
},
"reference": {
"type": "string"
},
"relationship": {
"type": "string"
}
},
"additionalProperties": false
}
},
"commentary_status": {
"enum": [
"found",
"searched_no_match",
"unavailable"
],
"type": "string"
},
"commentary_work_count": {
"type": "integer"
},
"commentary_entry_count": {
"type": "integer"
},
"commentary_text_included": {
"type": "boolean"
}
},
"description": "Available commentary entries and verified internal report links, including in compact responses. Missing attached commentary does not imply no scholarly discussion exists.",
"additionalProperties": false
},
"translation_matches": {
"type": "array",
"items": {
"type": "object",
"required": [
"source_alias",
"source_name_english",
"source_name_arabic",
"language",
"text"
],
"properties": {
"text": {
"type": "string"
},
"language": {
"type": [
"string",
"null"
]
},
"source_alias": {
"type": [
"string",
"null"
]
},
"source_name_arabic": {
"type": [
"string",
"null"
]
},
"source_name_english": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"description": "Distinct translation matches merged under the canonical Quran ayah."
}
},
"description": "A normalized Quran, hadith, sirah, or history record.",
"additionalProperties": false
},
"minItems": 1
},
"canonical_url": {
"type": "string"
},
"response_profile": {
"enum": [
"compact",
"default",
"full"
],
"type": "string"
},
"requested_reference": {
"type": "string"
}
},
"additionalProperties": false
}lookup_hadith_detail annotations
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-07: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 616 ms
- 95th percentile latency
- 616 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 616 ms · metadata changed · 19 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
Claude Code configuration
claude mcp add --transport http hadithdb-mcp https://hadithunlocked.com/mcpCodex
Codex configuration
codex mcp add hadithdb-mcp --url https://hadithunlocked.com/mcpCursor
Cursor configuration
{
"mcpServers": {
"hadithdb-mcp": {
"url": "https://hadithunlocked.com/mcp"
}
}
}Cline
Cline configuration
{
"mcpServers": {
"hadithdb-mcp": {
"type": "streamableHttp",
"url": "https://hadithunlocked.com/mcp",
"disabled": false
}
}
}VS Code
VS Code configuration
{
"servers": {
"hadithdb-mcp": {
"type": "http",
"url": "https://hadithunlocked.com/mcp"
}
}
}Gemini CLI
Gemini CLI configuration
gemini mcp add --transport http hadithdb-mcp https://hadithunlocked.com/mcpClaude Desktop
Claude Desktop configuration
https://hadithunlocked.com/mcpWindsurf
Windsurf configuration
{
"mcpServers": {
"hadithdb-mcp": {
"serverUrl": "https://hadithunlocked.com/mcp"
}
}
}Let your agent find its tools
Find servers like HadithDB MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.