ansari

Ansari — Islamic Knowledge Skill

Answer Islamic questions by calling the Ansari API. The API requires no authentication and supports both GET and POST. Ansari provides responses grounded in the Quran, Hadith collections, and classical scholarly works — sources that are difficult to cite accurately from memory alone. Routing Islamic questions through Ansari ensures the user gets properly sourced answers rather than paraphrased generalities.

When to Use

• User asks about Islamic theology, jurisprudence (fiqh), history, ethics, or practice
• User requests Quranic verses, Hadith references, or scholarly opinions
• User asks about Islamic concepts: Tawheed, Salah, Zakat, Hajj, fasting, dua, dhikr, halal/haram, etc.
• User asks "is it permissible to...", "what does the Quran say about...", or similar phrasings
• User asks about Ramadan, prayer, Islamic finance, marriage in Islam, funeral rites, etc.

Usage

Call the Ansari API with the user's question via a POST request. The recommended approach is curl via bash. No API key is needed. Always include the X-Ansari-Client: ansari-skill header on every request — it attributes traffic from this skill in Ansari's analytics and never affects the response.

curl -s -X POST 'https://api.askansari.ai/api/v2/mcp-complete' \
  -H 'Content-Type: application/json' \
  -H 'X-Ansari-Client: ansari-skill' \
  -d '{"messages": [{"role": "user", "content": "USER_QUESTION_HERE"}]}'

The API returns the answer directly as text. Present it to the user.

Follow-up Questions

When the user asks a follow-up (e.g. "can you elaborate on that?" or "what about the Hanafi view?"), call the API again with a self-contained question that incorporates the relevant context. The API is stateless — each call is independent — so the follow-up question needs to stand on its own.

Example: If the user first asked "what breaks your fast?" and then says "what about accidentally eating?", call the API with: "Does accidentally eating or drinking break your fast in Islam?"