Fanar
Cited Islamic Q&A, Qur'an and hadith quote checks, Arabic translation and speech
- Pricing
- Free
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 0.1.1
- Listing updated
- 3 days ago
Similar MCP servers
About Fanar
Fanar is a free MCP server for religion. It runs locally on your machine and is started by your AI client.
This server fronts Fanar, an Arabic-centric AI platform from QCRI at Hamad Bin Khalifa University, through an independent open-source project by Blade Labs that is not affiliated with QCRI or HBKU. It is alpha status and built first for the Islamic finance community: ask a fiqh question and get sources, check every Qur'an and hadith quotation in a draft before publishing, and translate classical Arabic texts.
Beyond Q&A it exposes Fanar's chat, deep research reports, Arabic-English translation, speech in both directions with ten voices and Qur'an reciters, culturally aware image generation, a moderation scorer and Arabic poetry. Each tool carries Fanar's default per-key limits, for example 50 a minute for Islamic Q&A and 20 a day for translation and speech.
The README is clear on responsible use: answers are cited answers, not fatwas, and binding questions should go to a qualified scholar. A quotation left untagged by the validator is unverified. An API key from api.fanar.qa is required, and Fanar deactivates keys after 90 days without use.
Install
Run in a terminal
claude mcp add fanar-mcp --env FANAR_API_KEY='<FANAR_API_KEY>' -- uvx fanar-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"fanar-mcp": {
"command": "uvx",
"args": [
"fanar-mcp"
],
"env": {
"FANAR_API_KEY": "<FANAR_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"fanar-mcp": {
"command": "uvx",
"args": [
"fanar-mcp"
],
"env": {
"FANAR_API_KEY": "<FANAR_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"fanar-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"fanar-mcp"
],
"env": {
"FANAR_API_KEY": "<FANAR_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"fanar-mcp": {
"command": "uvx",
"args": [
"fanar-mcp"
],
"env": {
"FANAR_API_KEY": "<FANAR_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"fanar-mcp": {
"command": "uvx",
"args": [
"fanar-mcp"
],
"env": {
"FANAR_API_KEY": "<FANAR_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
FANAR_API_KEYYour Fanar API key, requested at https://api.fanar.qa/requestRequired
Tools this server provides (12)
Taken from the project documentation; the running server may differ.
- fanar_list_models
- List models your key may call.
- fanar_chat
- Chat in Arabic or English.
- fanar_islamic_qa
- Islamic Q&A with references.
- fanar_validate_quotations
- Find and verify Qur'an and hadith quotations.
- fanar_deep_research
- Start a structured, cited research report.
- fanar_deep_research_result
- Fetch a deep research result.
- fanar_translate
- Arabic-English translation.
- fanar_text_to_speech
- Arabic or English speech.
- fanar_transcribe
- Speech to text.
- fanar_generate_image
- Culturally aware image generation.
- fanar_moderate
- Safety and cultural-awareness scores.
- fanar_poem
- Arabic poetry in the classical tradition.
What it does
- Cited Islamic Q&A
- Answers with references and madhab and source filters.
- Quotation checks
- Finds and verifies Qur'an and hadith quotations in text.
- Deep research
- Structured, cited reports on Islamic topics.
- Arabic translation
- Arabic-English translation including classical texts.
- Speech both ways
- Text to speech and transcription in Arabic and English.
- Quota reporting
- Every result shows remaining quota.
Good for
- Check quotations in a draft before publishing
- Ask a fiqh question and get cited sources
- Translate a classical Arabic passage
- Transcribe an Arabic recording
- Research an Islamic finance topic
Pricing
Free
Apache-2.0 server; Fanar API key and Fanar's terms apply
Fanar FAQ
Do I need an API key?
Yes, request one at api.fanar.qa; unused keys deactivate after 90 days.
Are answers fatwas?
No; the README says they are cited answers and binding questions should go to a qualified scholar.
Is it official?
No, it is an independent project not affiliated with QCRI or HBKU.
What does it need to run?
Python 3.10 or later, for example via uvx fanar-mcp.
Is Fanar free?
Yes. Fanar is free to use.
How do I add Fanar to Claude Code?
Run this command in your terminal: claude mcp add fanar-mcp --env FANAR_API_KEY='<FANAR_API_KEY>' -- uvx fanar-mcp
What are the best alternatives to Fanar?
The closest alternatives to Fanar are Madeenan Quran and Hadith Sources, Quran Gallery MCP, Read Quran Today, Iqamah prayer times and Awwab Qibla & Quiz.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
