Model Context Protocol

IslamQA + AI —
grounded, not guesswork.

An MCP server that serves verified fatwa text from IslamQA.info —English primary, Arabic when available —so assistants cite real data instead of quoting from memory.

Why ground IslamQA answers?

Without grounding
  • Paraphrased fatwas from training data
  • Wrong or invented answer numbers
  • Links to random hadith or fatwa sites
  • No way to verify what the AI said
With islamqa-mcp
  • Exact English & Arabic text from the corpus
  • Correct IslamQA answer ID on every row
  • Canonical proof URL + link to islamqa.info
  • Semantic + keyword search over 32 000+ answers

How It Works

  1. 1
    You ask the AI about a ruling or topic.

    A specific question, a thematic search, or “what does IslamQA say about…?”

  2. 2
    The AI calls islamqa-mcp.

    It retrieves verified question, answer, categories, and metadata from a local database built from the official IslamQA.info corpus (via sitemaps).

  3. 3
    The response is grounded.

    The AI cites answer IDs, includes the url proof link, and can point to the original source_url_en / source_url_ar on islamqa.info.

Available Tools

The MCP server exposes five tools. The AI picks the right one based on what you ask.

fetch_grounding_rules

Citation guidance and limitations once per session. Re-calls return a short repeat unless force_full=True.

list_categories

Lists topic categories with English and Arabic names and answer counts.

fetch_answer

Fetch one fatwa by IslamQA answer_id. Returns English + Arabic fields and categories when available.

search_answers

Semantic search (default), keyword (SQL substring), or both. Optional category filter. Falls back to keyword on rate limits.

show_answer

Opens an interactive IslamQA Reader app in supported MCP hosts. Entry points: answer_id (preferred), free-text query, or no arguments to browse. Includes a text fallback with the same url for hosts without app support.

IslamQA Search Web App

Use search.islamqa-mcp.org to verify AI outputs, explore results, and share proof links.

Verify AI citations

Open the search app to check the exact row text and metadata when an assistant cites an answer ID.

Direct ID lookup

Supports patterns like #264334 so it matches real AI output formats.

Shareable proof links

Every result has a canonical search.islamqa-mcp.org/?id= link plus View on IslamQA.

Setup

Checking server…
https://islamqa-mcp.org

Connect this server to any MCP client. One-time setup, then it just works.

Claude (Web & Desktop)

Requires a Claude subscription.

1
Open Connectors

Settings → Connectors → Customize.

2
Add custom connector

Click + → Add custom connector.

3
Configure
Name islamqa
URL https://islamqa-mcp.org
4
Allow all tools

Set every tool to Always allow (read-only).

5
Use it

Enable the islamqa connector in a new chat.

ChatGPT

1
Settings → Apps → Advanced
2
Enable Developer mode
3
Create app
Name islamqa
URL https://islamqa-mcp.org
4
Use

Invoke with @islamqa in chat.

Cursor

1
MCP settings

Settings → MCP → Add new MCP server.

2
Type streamable-http
URL https://islamqa-mcp.org

Other MCP Clients

1
JSON connection object
{
  "name": "islamqa",
  "url": "https://islamqa-mcp.org",
  "transport": "streamable-http"
}
2
Claude Desktop config
{
  "mcpServers": {
    "islamqa": {
      "url": "https://islamqa-mcp.org",
      "transport": "streamable-http"
    }
  }
}

Grounding & Limitations

Source of truth

Text from islamqa.db, scraped from IslamQA.info. Prefer tool output over paraphrase.

Citations

Always include answer ID and the url field. Use source_url_en / source_url_ar for the original page.

English / Arabic

English is primary for search and display. Arabic is available when scraped; toggle in the search app.

Not a mufti

Reflects IslamQA's scholarly approach, not universal consensus. Consult a qualified scholar for personal rulings.

Search limits

Semantic search needs embeddings (OpenAI). Keyword search is substring-based. Neither ranks by scholarly importance.

Updates

Corpus is refreshed from sitemaps on a schedule. New answers appear after scrape + embed + rebuild.

Important — Please Read

This tool retrieves fatwa text from a database. It is not a scholar, a mufti, or a substitute for qualified Islamic scholarship. AI can still misinterpret context or apply text without nuance.

Do not blindly trust any AI output on religious matters. Verify citations against IslamQA.info. Consult qualified scholars for fiqh and personal practice.

We are not affiliated with IslamQA.info. Data is republished for search and grounding purposes with attribution links.