Fanar MCP server

by Blade-Labs·io.github.Blade-Labs/fanar-mcp·v0.1.1

No reviews yet

Fanar (QCRI) for MCP: cited Islamic Q&A, Qur'an and hadith checks, Arabic translation and speech

A85/100grade A

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

A85/100

full report

Adoption

Growing

0 stars152 downloads/wk

Reviews

Write one

Nobody has reviewed Fanar yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Fanar tools (12)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

fanar_chat
Chat with a Fanar language model. Fanar-C-2-27B is the Fanar 2.0 27B model for Arabic (MSA and Gulf, Levantine and Egyptian dialects) and English; "Fanar" is the default alias. Set thinking=true for step-by-step reasoning. About 50 requests a minute.
fanar_deep_research
Start a Fanar-Sadiq-2 deep research job: a structured report on an Islamic topic, with headings and cited sources. It takes minutes (quick about 3-6, standard about 7-10); poll it with fanar_deep_research_result. Requires Fanar-Sadiq-2 on the key. About 20 jobs a day.
fanar_deep_research_result
Fetch the status, progress or finished report of a Fanar-Sadiq-2 deep research job.
fanar_generate_image
Generate a culturally aware image with Fanar Oryx and save it; returns the file path and the prompt as Fanar revised it. About 20 requests a day.
fanar_islamic_qa
Ask Fanar-Sadiq an Islamic question and get an answer grounded in cited sources such as the Qur'an, hadith collections and fatwa collections. Show the references with the answer and present it as a cited answer, never as a fatwa. Fanar-Sadiq-2 adds madhab and source filters when your key is entitled to it; madhab is a list such as ["hanafi"], from all, hanafi, maliki, shafii and hanbali. About 50
fanar_list_models
List the Fanar models this API key may call. Entitlements differ per key: for example Fanar-Sadiq-2, which powers the quotation validator and deep research, must be enabled by Fanar.
fanar_moderate
Score a prompt and response pair with FanarGuard for safety and cultural awareness, in Arabic or English. Requires Fanar-Guard-2 on the key.
fanar_poem
Compose Arabic poetry in the classical tradition with Fanar-Diwan. Requires Fanar-Diwan on the key.
fanar_text_to_speech
Speak Arabic or English text with a Fanar Aura voice and save it as an audio file; returns the file path. Qur'an recitation by a named reciter needs Fanar-Sadiq-TTS-1. About 20 requests a day.
fanar_transcribe
Transcribe Arabic (including dialects) or English audio from a local file with Fanar Aura. long_form=true uses the long-audio model (about 10 requests a day); otherwise about 20 a day.
fanar_translate
Translate between Arabic and English with Fanar's Shaheen models, including classical Arabic such as hadith and fiqh texts. About 20 requests a day; keep each request under about 4,000 words.
fanar_validate_quotations
Detect and verify Qur'an and hadith quotations inside any text: an LLM answer, a draft, an article. Verified quotations come back tagged and linked to canonical sources; a quotation left untagged could not be confirmed and must be treated as unverified. Requires Fanar-Sadiq-2 on the key. About 200 requests a minute.

Public scan report

scanner v0.1.10 · 2026-10-27 · same rubric, same numbers if you re-run it

no findings

Code scan6 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 7 days ago15/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10

Overall 85/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Fanar compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 85/100; higher than 70% of 48,255 servers
Tools: 12; the typical server has 7
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
Downloads a week: 152; more than 71% of 12,191 servers with a package

What its tools let an agent do: 12 read

Install Fanar in Claude Code, Cursor or VS Code

claude mcp add fanar-mcp -- uvx fanar-mcp

Add to Cursor

What the publisher says

From the Fanar repository's README, as published. We do not edit it. Read it on GitHub

fanar-mcp

A Model Context Protocol server for Fanar, the Arabic-centric generative AI platform built by QCRI at Hamad Bin Khalifa University. It gives any MCP client (Claude Desktop, Claude Code, Cursor, and other agent harnesses) Fanar's chat models, cited Islamic question answering, Qur'an and hadith quotation checks, deep research, Arabic-English translation, Arabic speech in both directions, and image generation.

Built for the Islamic finance community first: ask a fiqh question and get the sources, check every quotation in a draft before it is published, and translate classical Arabic texts.

Independent open-source project by Blade Labs. Not affiliated with or endorsed by QCRI or HBKU.

Status: alpha.

Tools

Limits are Fanar's published defaults; every result carries the remaining quota Fanar reports. A tool that needs a model your key lacks returns a clear error with the link to request access.

Prompts: islamicfinancequestion (answer with sources and checked quotations) and verifyislamicquotations (check a text before publishing).

Get a key

Request API access at . Fanar deactivates keys after 90 days without use.

Install and configure

Requires Python 3.10 or later.

pip install fanar-mcp          # or run it without installing: uvx fanar-mcp
uvx --from git+https://github.com/Blade-Labs/fanar-mcp fanar-mcp   # straight from GitHub

Claude Desktop (claudedesktopconfig.json):

{
  "mcpServers": {
    "fanar": {
      "command": "uvx",
      "args": ["fanar-mcp"],
      "env": { "FANAR_API_KEY": "your-key" }
    }
  }
}

Claude Code:

claude mcp add fanar -e FANAR_API_KEY=your-key -- uvx fanar-mcp

Cursor and other clients take the same command (uvx fanar-mcp) and the FANARAPIKEY variable. For a shared server, run fanar-mcp --transport streamable-http --port 8765.

Environment variables: FANARAPIKEY (required), FANARBASEURL (default https://api.fanar.qa/v1), FANARMCPOUTPUT_DIR (where audio and images are saved; default ~/fanar-mcp-output).

Responsible use

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Fanar: common questions

Is Fanar MCP server safe?: Yes, by our scan: it is graded A (85/100). Read the Fanar safety report
How do I install Fanar?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Fanar need an API key?: Yes. The registry entry asks for FANAR_API_KEY.
Is Fanar maintained?: The last commit was 15 days ago (2026-10-20). The latest release is v0.1.1.
How does Fanar compare with other MCP servers?: safety score 85/100 (higher than 70% of 48,255 servers); tools 12 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.