Turath MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Turath Islamic library. Find ids with turath_find_in_catalog or turath_list_categories, then read with turath_get_page(s). Quote Arabic text exactly and cite book, author and page.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tasks | {
"list": {},
"cancel": {},
"requests": {
"tools": {
"call": {}
}
}
} |
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
| completions | {} |
| experimental | {
"turath/arabic-normalization": {
"version": "1"
}
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| turath_searchB | Full-text search across the Turath Islamic library. Arabic queries work best. |
| turath_get_pageB | Fetch the text of one page of a book. |
| turath_get_pagesA | Fetch up to 10 consecutive pages of a book in one call. |
| turath_get_bookC | Book metadata, optionally with its table of contents (indexes). |
| turath_get_authorA | Author details: name, death year and the ids of their books (from the Turath catalog), merged with live details from the author API when available. |
| turath_list_categoriesA | List all Turath book categories (id, name, number of books). Use turath_get_category for one category. |
| turath_get_categoryA | One category with its books. Books are paged; use offset/limit to walk large categories. |
| turath_find_in_catalogB | Search the Turath catalog (data-v3.json) by name; Arabic diacritics and letter variants are ignored. |
| turath_summarize_pageA | Fetches a page and asks the client's own model to summarize it. Requires a client with sampling support. |
| turath_get_book_fileA | Fetch the static JSON of a whole book (large). Asks for confirmation if the client supports elicitation. Output is truncated. |
| turath_export_pagesB | Saves a page range as a .md file in a turath-exports folder: inside the client root if shared, otherwise TURATH_EXPORT_DIR, otherwise the home directory. |
| turath_fetch_pages_taskA | Fetches up to 100 consecutive pages as a background task; poll with tasks/get and read with tasks/result. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| research_topic | Search Turath and summarize findings with book and page citations. |
| explore_category | Browse a Turath category and recommend where to start reading. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| categories | All categories with book counts |
| العقيدة | A category and its book ids |
| الفرق والردود | A category and its book ids |
| التفسير | A category and its book ids |
| علوم القرآن وأصول التفسير | A category and its book ids |
| التجويد والقراءات | A category and its book ids |
| كتب السنة | A category and its book ids |
| شروح الحديث | A category and its book ids |
| التخريج والأطراف | A category and its book ids |
| العلل والسؤلات الحديثية | A category and its book ids |
| علوم الحديث | A category and its book ids |
| أصول الفقه | A category and its book ids |
| علوم الفقه والقواعد الفقهية | A category and its book ids |
| المنطق | A category and its book ids |
| الفقه الحنفي | A category and its book ids |
| الفقه المالكي | A category and its book ids |
| الفقه الشافعي | A category and its book ids |
| الفقه الحنبلي | A category and its book ids |
| الفقه العام | A category and its book ids |
| مسائل فقهية | A category and its book ids |
| السياسة الشرعية والقضاء | A category and its book ids |
| الفرائض والوصايا | A category and its book ids |
| الفتاوى | A category and its book ids |
| الرقائق والآداب والأذكار | A category and its book ids |
| السيرة النبوية | A category and its book ids |
| التاريخ | A category and its book ids |
| التراجم والطبقات | A category and its book ids |
| الأنساب | A category and its book ids |
| البلدان والرحلات | A category and its book ids |
| كتب اللغة | A category and its book ids |
| الغريب والمعاجم | A category and its book ids |
| النحو والصرف | A category and its book ids |
| الأدب | A category and its book ids |
| العروض والقوافي | A category and its book ids |
| الشعر ودواوينه | A category and its book ids |
| البلاغة | A category and its book ids |
| الجوامع | A category and its book ids |
| فهارس الكتب والأدلة | A category and its book ids |
| الطب | A category and its book ids |
| كتب عامة | A category and its book ids |
| علوم أخرى | A category and its book ids |
TDQS
Scored across 12 tools
Most tools target distinct resources (search, book, author, category, catalog, export), but the page-fetching family — turath_get_page, turath_get_pages, turath_fetch_pages_task, and turath_get_book_file — overlaps in purpose and is differentiated only by size/mechanism. turath_search (full-text) vs turath_find_in_catalog (catalog name search) could also be briefly confused, though the descriptions do draw the line.
All twelve tools follow a turath_ prefix with snake_case verb_noun structure (get_page, list_categories, export_pages), which is highly predictable. Minor deviation: get vs fetch verbs are mixed for page retrieval (turath_get_pages vs turath_fetch_pages_task), but the pattern remains readable.
Twelve tools is well within the ideal 3-15 range for a library server. Each tool earns its place: search, browsing hierarchy (categories → category → book → author), page retrieval at three scales, plus summarize/export/task utilities.
The read-only domain is well covered: search, category listing and drill-down, book metadata/TOC, author details, page retrieval at multiple granularities, plus export and summarization. Minor gaps: no dedicated author listing/browse tool (only catalog name search) and no way to navigate pages relative to a search hit, but agents can work around these.