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