Skip to content
MCP server

Fanar

Cited Islamic Q&A, Qur'an and hadith quote checks, Arabic translation and speech

Runs locally
Install
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-mcp

Add 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.

How AIPoweredBot checks servers