ع
3arif.ai
Open app
● Open API — free to use

3arif for Developers

Bring cited Islamic knowledge into your app, chatbot, or research tool. Grounded in 50+ classical and contemporary sources — Quran, hadith, tafsir, fiqh, history.

Get API Key API Docs GitHub
50+
Islamic sources
6
query modes
Free
to use

Quick start

curl https://api.3arif.ai/v1/ask \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "What is the ruling on fasting during Ramadan for travellers?",
    "mode": "shariah",
    "include_sources": true
  }'

Endpoints

Base URL: https://api.3arif.ai · Full interactive docs →

POST/v1/ask
Ask a question, get a cited answer
GET/v1/verse/{s}/{a}
Retrieve a Quran verse by surah:ayah
GET/v1/sources
List all knowledge sources in the corpus
GET/v1/modes
List available query modes
GET/v1/health
Liveness check

Query modes

Pass "mode" in your request to control depth and focus.

fast

Quick answer, general audience. Quran + tafsir only.

long

Detailed cross-sectarian answer with multiple perspectives.

research

Academic article format. Full citation trail.

shariah

Islamic legal ruling. Comparative madhab positions.

historian

Historical narrative with dated events and primary sources.

mystic

Sufi / spiritual lens. Draws from Qushayri, Ibn Arabi tradition.

MCP server for Claude Desktop

Install arif-mcp and 3arif becomes a native tool inside Claude Desktop, Cursor, and any other MCP-compatible client.

5 tools

ask, verse lookup, source search, modes, corpus browse

stdio transport

Works with Claude Desktop, Cursor, Zed, and more

Open source

MIT licensed, full source on GitHub

pip install arif-mcp
# or: uvx arif-mcp

Get your API key

Free. No credit card. We'll email your key within 24 hours.

By requesting a key you agree to use 3arif responsibly and not resell API access. Questions? dev@3arif.ai

3arif.ai · Open source · MIT licensed · GitHub