# Fanar

> Fanar is a free MCP server for religion. Cited Islamic Q&A, Qur'an and hadith quote checks, Arabic translation and speech. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, API
- **Repository:** https://github.com/blade-labs/fanar-mcp
- **MCP Registry name:** io.github.Blade-Labs/fanar-mcp
- **Categories:** [religion](https://ai-powered.com/categories/religion), [education and exams](https://ai-powered.com/categories/education-and-exams)
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add fanar-mcp --env FANAR_API_KEY='<FANAR_API_KEY>' -- uvx fanar-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "fanar-mcp": {
      "command": "uvx",
      "args": [
        "fanar-mcp"
      ],
      "env": {
        "FANAR_API_KEY": "<FANAR_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "fanar-mcp": {
      "command": "uvx",
      "args": [
        "fanar-mcp"
      ],
      "env": {
        "FANAR_API_KEY": "<FANAR_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "fanar-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "fanar-mcp"
      ],
      "env": {
        "FANAR_API_KEY": "<FANAR_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "fanar-mcp": {
      "command": "uvx",
      "args": [
        "fanar-mcp"
      ],
      "env": {
        "FANAR_API_KEY": "<FANAR_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "fanar-mcp": {
      "command": "uvx",
      "args": [
        "fanar-mcp"
      ],
      "env": {
        "FANAR_API_KEY": "<FANAR_API_KEY>"
      }
    }
  }
}
```

## Tools

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

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

## Alternatives

- [Madeenan Quran and Hadith Sources](https://ai-powered.com/mcp/madeenan-quran-and-hadith-sources): Madeenan Quran and Hadith Sources is a freemium MCP server for religion.
- [Quran Gallery MCP](https://ai-powered.com/mcp/quran-gallery-mcp): Quran Gallery MCP is a free MCP server for religion.
- [Read Quran Today](https://ai-powered.com/mcp/read-quran-today): Read Quran Today is a free MCP server for religion.
- [Iqamah prayer times](https://ai-powered.com/mcp/iqamah-prayer-times): Iqamah prayer times is a free MCP server for religion.
- [Awwab Qibla & Quiz](https://ai-powered.com/mcp/awwab-qibla-and-quiz): Awwab Qibla & Quiz is a free MCP server for religion.
- [Salah Flow](https://ai-powered.com/mcp/salah-flow): Salah Flow is a free MCP server for religion.
- [فکرستان (Fekrestan)](https://ai-powered.com/mcp/fekrestan): فکرستان (Fekrestan) is a freemium MCP server for education and exams.
- [Islam West Africa Collection (IWAC)](https://ai-powered.com/mcp/islam-west-africa-collection-iwac): Islam West Africa Collection (IWAC) is a free MCP server for news and media.

---
Source: https://ai-powered.com/mcp/fanar
