canonical: https://jentic.com/apis/amanahagent.cloud/amanahagent # Amanahagent Amanah Sunnah API The Amanah Sunnah API provides programmatic access to a verified Islamic knowledge base covering Quran verses, Tafsir Ibn Kathir, hadith from seven major collections, narrator records, Aqidah and Tawhid texts, duas, and daily sunnah practices. It runs hybrid semantic and keyword search over that corpus and answers natural-language questions with supporting dalil through a retrieval-augmented endpoint. Individual verses, hadith, and tafsir entries can also be fetched directly by reference key. ## For AI agents Search a verified Islamic knowledge base of Quran, hadith, and tafsir, fetch entries by key, and get natural-language answers with supporting dalil. ## Scope Does not issue personal religious rulings, process payments, or host open-ended chat. Use for searching and retrieving verified Islamic texts and sourced answers only. ## Capabilities - Look up a Quran ayah or a hadith by its reference key - Run hybrid semantic and keyword search across the verse and hadith corpus - Ask a question and get an answer with supporting dalil from verified references - Retrieve Tafsir Ibn Kathir for a given ayah - Search hadith narrators and read Aqidah and Tawhid explanations - List daily sunnah practices, duas, and the 99 Names of Allah ## Use cases ### AI agent answering Islamic questions with sources An assistant needs to answer questions about Islamic practice while citing where each answer comes from. Through Jentic the agent searches for asking a question with supporting dalil, loads the question-answering operation with the API key already injected, and returns an answer grounded in the verified corpus rather than the model's own recollection. The citations let a reader verify each point. Example prompt: Call POST /ask with a question about fasting and return the answer together with the dalil references it cites ### Quran and hadith lookup bot A study bot resolves a reference the user gives, such as a surah and ayah or a hadith key, and returns the text plus its tafsir. The Amanah Sunnah API fetches a single ayah or hadith by key and serves Tafsir Ibn Kathir for an ayah, so the bot can show the verse, its explanation, and the hadith it mentions. This turns a reference into a complete reading in one exchange. Example prompt: Call GET `/quran/{key}` for the ayah, then GET `/tafsir/{key}` to attach its Tafsir Ibn Kathir ### Semantic study assistant A learner asks about a theme rather than a specific reference, such as patience or gratitude. The API's hybrid search combines semantic matching with keyword matching across verses and hadith, so an agent can surface the most relevant passages even when the user's wording does not match the text exactly. Results come back ranked for the agent to summarize. Example prompt: Call POST /search with the query 'patience in hardship' and return the top matching verses and hadith ### Daily sunnah reminders A reminder agent pulls the recommended practices, duas, and calendar events for the day to prompt a user. The Amanah Sunnah API lists daily sunnah practices, authentic duas, and sunnah calendar events, so the agent can assemble a short daily message grounded in the corpus. This keeps the content consistent and sourced rather than freely generated. Example prompt: Call GET /amalan for today's practices and GET /doa for a matching dua, then compose a reminder ## Key endpoints | Method | Path | Description | | --- | --- | --- | | POST | `/search` | Run hybrid semantic and keyword search over the corpus | | POST | `/ask` | Ask a question and get an answer with dalil | | GET | `/quran/{key}` | Get a Quran ayah by reference key | | GET | `/hadith/{key}` | Get a hadith by reference key | | GET | `/tafsir/{key}` | Get Tafsir Ibn Kathir for an ayah | | GET | `/rijal` | Search hadith narrators | | GET | `/amalan` | Get daily sunnah practices | ## Key resources - **Search and Q&A** — Hybrid semantic and keyword search over the corpus and retrieval-augmented question answering with dalil - **Texts** — Fetch Quran ayat, hadith, and Tafsir Ibn Kathir by reference key - **Knowledge collections** — Narrators, Aqidah and Tawhid chapters, duas, daily practices, the 99 Names of Allah, and fabricated-hadith lists ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 45 / 100 - **Maturity:** Foundational - **Dimensions:** - Foundational Compliance: 99 / 100 - Developer Experience & Jentic Compatibility: 59 / 100 - AI-Readiness & Agent Experience: 20 / 100 - Agent Usability: 94 / 100 - Security: 50 / 100 - AI Discoverability: 81 / 100 - **View full report:** https://jentic.com/apis/amanahagent.cloud/amanahagent/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the Amanah Sunnah API by hand means obtaining an API key, sending it in the X-API-Key header on every call, and handling the request shapes for its hybrid search and question-answering endpoints yourself. Through Jentic you install once, import Amanah Sunnah from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** The Amanah Sunnah API is mostly read lookups and search, with a lecture submission webhook as its one write path. You choose the operations your agent may call, so you can allow the verse, hadith, and search reads and leave the lecture submission out of the allowed set unless you add it. - **Credential handling:** Your Amanah Sunnah key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'search Islamic texts' or 'get a Quran ayah', and Jentic returns the matching Amanah Sunnah operation with its input schema so the agent calls the right endpoint without reading the reference docs. ## Related APIs - **Algolia Search API** — A general-purpose hosted search engine you index your own content into, rather than a ready-made Islamic corpus - **Hugging Face API** — Runs embedding and language models you can pair with retrieved passages for downstream processing - **Contextual AI API** — A retrieval-augmented generation platform for building grounded answers over your own documents ## FAQ ### What authentication does the Amanah Sunnah API use? The Amanah Sunnah API authenticates with an API key sent in the X-API-Key request header, per its OpenAPI spec. Every operation in the spec expects that header. Through Jentic the key is stored once and injected at call time, so the agent never handles the raw key. ### Can I get an answer with supporting evidence from the Amanah Sunnah API? Yes. Call POST /ask with a natural-language question and the API returns an answer together with the dalil it draws from the verified corpus, rather than an unsourced generation. For passage discovery without a full answer, POST /search returns ranked verses and hadith for a query. ### What are the rate limits for the Amanah Sunnah API? The OpenAPI spec does not define request-rate ceilings. Limits are tied to the issued API key and the plan it belongs to. Check the Amanah Sunnah developer documentation for the quota on your key before running large search or question-answering batches. ### Is there an Amanah Sunnah API MCP server? You don't need an MCP server to give your agent the Amanah Sunnah API. Jentic connects it directly from the API Directory: import the API, store your key once, and your agent calls operations such as POST /search on demand without loading another server's tool definitions into its context. ### Can I limit what my agent is allowed to do with the Amanah Sunnah API? Yes. Write a rule that allows only the lookup and search operations, so the agent can read verses, hadith, and tafsir and run searches but cannot submit a lecture to the processing webhook, and every call it makes is logged. The one write path stays out of the allowed set until you add it. ### How do I search the hadith corpus through Jentic? Search Jentic for 'search Islamic texts', load the POST /search operation, and run it after your API key is stored. To run it on your own infrastructure, install Jentic One from its GitHub repo. ### Which collections does the Amanah Sunnah API cover? The corpus spans Quran verses with Tafsir Ibn Kathir, hadith from seven major collections, narrator records, Kitab At-Tawhid chapters, Aqidah texts, duas, daily sunnah practices, the 99 Names of Allah, and lists of known fabricated hadith. An agent can call GET /rijal for narrators or GET /tawhid for Tawhid chapters to work with a specific collection.