Alfanous - Quranic Search Engine

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/alfanous-team-alfanous

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

11 read · 0 write · 0 deleteRead-only

Secrets

None asked for

Install scripts

None found

Runs as

Python package

Tools (11)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• correct_queryCorrect Query Spelling

  Correct spelling mistakes in a Quranic search query. Uses the Whoosh query corrector to replace unknown terms with the closest matching terms found in the index vocabulary. Returns the original query alongside the best corrected version. When the query is already valid the corrected string is identical to the original. Useful as a pre-processing step before calling search_quran. EXAMPLES Misspelled Arabic: query='الرخمن' → corrected: 'الرحمن' Misspelled Buckwalter: query='rHmAn' → corrected to nearest term Already correct: query='الرحمن' → corrected equals original Multi-term…

• get_quran_infoGet Qur'an Metadata

  Retrieve metadata about the Qur'an index and the Alfanous API. Available categories: 'chapters', 'surates', 'translations', 'recitations', 'defaults', 'domains', 'fields', 'flags', 'help_messages', 'hints', 'information', 'errors', 'ai_query_translation_rules', or 'all' for everything at once. EXAMPLES List all chapter names: category='chapters' List all translation identifiers: category='translations' → returns IDs like 'en.sahih', 'en.pickthall', 'fr.hamidullah' List available recitations: category='recitations' View default parameter values: category='def…

• get_word_children_schemaGet Word Children Schema

  Return detailed documentation about the Quranic word children schema and how to search word-level morphological data. Covers all indexed fields (part of speech, root, lemma, gender, number, person, voice, aspect, derivation, and more), parent-child nesting logic, query syntax examples, and the relationship between word children and the aya-level tuple/derivation query plugins. WHEN TO USE Call this tool before using search_by_word_linguistics for the first time to understand all available fields, accepted values, and query syntax. Also useful when constructing advanced raw queries with unit…

• list_field_valuesList Indexed Field Values

  Return every unique value indexed for a given field. Use this to discover available word annotation categories (part of speech, grammatical gender, number, verb aspect, voice, derivation, etc.) before calling search_by_word_linguistics, or to see the available translation identifiers before calling search_translations. Call with field='pos' for all part-of-speech tags, field='gender' for all gender values, field='trans_id' for all translation IDs, and so on. The tool also returns a catalogue of well-known word-annotation fields and translation-related fields as a convenience reference. EXAMPL…

• search_by_word_linguisticsSearch Qur'an Words by Linguistics

  Search Quranic word occurrences by their morphological and linguistic properties. Each word token in the Qur'an is indexed with its part of speech, grammatical type, Arabic root, lemma, gender, number, person, verb aspect, voice, nominal state, derivation, and more. Use this tool for linguistic analysis — e.g. find all nouns derived from a specific root, all verbs in the passive voice, or all words with a particular part of speech. An optional free-text query can also search the vocalized or unvocalized word form directly. EXAMPLES All words from root رحم: root='رحم' All verb …

• search_quranSearch the Qur'an

  Search for verses in the Holy Qur'an. The query supports Arabic text, Buckwalter transliteration, boolean operators (AND / OR / NOT), phrase search ("…"), wildcards (* and ?), field-specific searches (e.g. sura_id:2 aya_id:255), fuzzy matching, synonyms, antonyms, and root-level derivations. Returns a paginated list of matching verses with metadata. EXAMPLES Single Arabic keyword: query='الرحمة' Buckwalter transliteration: query='rHmn' Exact phrase: query='"بسم الله الرحمن الرحيم"' Boolean AND: query='رحمة AND مغفرة' Boolean OR: …

• search_quran_by_positionSearch Qur'an by Position

  Search for Quranic verses by their structural position. Filter by sura (chapter) number, verse number, juz (part), hizb, ruku, or page. Accepts exact values or Whoosh range expressions (e.g. '[2 TO 5]'). Use this tool to retrieve verses from a specific location or range within the Qur'an's structural divisions. EXAMPLES A single verse (Ayat al-Kursi): sura_number='2', verse_number='255' All verses of Sura Al-Fatiha: sura_number='1' Suras 2 through 4: sura_number='[2 TO 4]' All verses in the first juz: juz='1' First three juz: juz='[1 TO 3]' Ve…

• search_quran_by_statsSearch Qur'an by Statistics

  Search for Quranic verses by statistical attributes. Filter by the number of words in a verse, the number of words or verses in a sura, or other numeric statistical fields. Accepts exact values or Whoosh range expressions (e.g. '[5 TO 10]'). Use this tool for statistical or linguistic analysis of the Qur'an. EXAMPLES Verses with exactly 4 words: words_in_verse='4' Verses with 5 to 10 words: words_in_verse='[5 TO 10]' Shortest verses first: words_in_verse='[1 TO 100]', sortedby='ayalength' Longest verses first: sortedby='ayalength', reverse=True Suras w…

• search_quran_by_themesSearch Qur'an by Themes

  Search for Quranic verses by thematic classification. Filter by chapter (broad thematic division), topic (subject area), and/or subtopic within the Qur'an's thematic index. An optional free-text query can further narrow results. Use this tool when looking for verses on a specific theme or subject matter. EXAMPLES Verses on prayer: topic='Prayer' Verses on a specific subtopic: topic='Prayer', subtopic='Salah' Broad thematic chapter: chapter='Stories of Prophets' Narrow to one prophet: chapter='Stories of Prophets', subtopic='Prophet Ibrahim' Theme …

• search_translationsSearch Qur'an Translations

  Search within Quranic translation texts (e.g. English, French, Urdu). Use this tool when the query is in a non-Arabic language or when the user wants to find verses by their translated meaning. Optionally specify a translation identifier (see get_quran_info with category='translations' for available options). Returns a paginated list of matching translation snippets with verse metadata. EXAMPLES Search all translations: query='mercy' Specific English translation: query='compassion', translation='en.pickthall' Sahih International: query='forgiveness', translation='en.sahih' …

• suggest_querySuggest Query Completions

  Get auto-completion suggestions for a partial Quranic search query. Useful for helping users refine their queries or correct spelling. EXAMPLES Suggest completions for 'رحم': query='رحم' → may return 'رحمة', 'رحمن', 'رحيم', … Suggest completions for 'Allh': query='Allh', unit='aya' (Buckwalter prefix) Suggest word-index completions: query='رحم', unit='word' Suggest translation completions: query='merc', unit='translation'

Signals

Stars

286

Forks

91

Open issues

20

Weekly downloads

88

Last commit

Jun 14, 2026 (4 months ago)

Last release

Jun 14, 2026 (4 months ago)

Last package publish

Jun 14, 2026 (4 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.Alfanous-team/alfanous

Version

1.9.4

Auth

No auth

Packages

pypi alfanous3-mcp

License

LGPL-3.0

Repository

github.com/Alfanous-team/alfanous

First seen

Oct 24, 2026

Last checked

Oct 25, 2026

Source

Official MCP Registrygithub-graphql