The halal compliance layer for your AI agent
Connect Claude, Cursor, or ChatGPT to HalalScreener and let your agent screen stocks for Shariah compliance under AAOIFI Standard No. 21 — with audited, explainable verdicts, purification, and the AI Scholar. Read-only and informational: never a trade gate.
Built for trust, not blind automation
Every verdict carries a methodology version, the ratios used, a freshness flag, a reproducible audit hash, and a “consult a scholar” flag. Verdicts are batch-screened (not real-time), not a fatwa, and assume a human in the loop. We never tell your agent to buy or sell.
Connect in 60 seconds
Option A — Local (Claude Desktop / Cursor)
Add this to your MCP client config, then restart the client:
{
"mcpServers": {
"halalscreener": {
"command": "npx",
"args": ["-y", "halalscreener-mcp"],
"env": { "HALALSCREENER_API_KEY": "hs_live_your_key" }
}
}
}Option B — Remote (Streamable HTTP)
For clients that support remote MCP servers, point them at the hosted endpoint with your key as a Bearer token:
https://halalscreener.app/api/mcp/mcp
Authorization: Bearer hs_live_your_keyTools
| Tool | Tier | What it does |
|---|---|---|
| screen_stock | Free | AAOIFI verdict + grade + reproducible audit hash for a symbol. |
| screen_portfolio | Free | Per-symbol verdicts plus a portfolio compliance summary. |
| get_stock_detail | Premium | Full financial + qualitative/quantitative breakdown. |
| explain_verdict | Premium | The auditable 'why' behind a verdict — the gate that drove it. |
| calculate_purification | Premium | Impure income to donate, per AAOIFI Standard No. 21. |
| ask_scholar | Premium | Conversational multi-madhab Islamic-finance Q&A (AI Scholar). |
| check_compliance_changes | Premium | Portfolio drift monitor — which holdings changed status since a date. |
| compliance_history | Premium | A stock's AAOIFI verdict timeline over time. |
Free tier: 3 verdict-only screens/month. Premium ($16.99/mo) unlocks full verdicts, the reasoning trail, purification, and the AI Scholar.
Make your agent halal-aware
Generate a key, paste the config, and your AI can screen any US-listed stock, ETF, or major crypto for Shariah compliance — with the receipts.
Get your API key