{
  "markdown": "# Daleel — Auditable Halal Stock Screening (Developer Hub)\n\n**دليل · Daleel** (Arabic for *evidence*) screens US-listed stocks and ETFs for\nSharia compliance — and shows its receipts. Every verdict cites the SEC filing\nbehind it: the XBRL tag, the form (10-K / 20-F / 40-F), the period, and a link\nto the filing on sec.gov. Five methodologies checked side by side: **AAOIFI,\nDJIM, MSCI, S&P, and FTSE**.\n\n**Live**: https://daleel.o11r.com · **Docs**: https://daleel.o11r.com/developers · **Methodology**: https://daleel.o11r.com/methodology\n\n> This repo is the public developer hub (docs, examples, MCP metadata).\n> The screening engine itself is closed source.\n\n## For AI agents (MCP)\n\nDaleel runs a Model Context Protocol server — connect any MCP-capable agent:\n\n```json\n{\n  \"mcpServers\": {\n    \"daleel\": {\n      \"type\": \"http\",\n      \"url\": \"https://daleel.o11r.com/mcp\"\n    }\n  }\n}\n```\n\nTools: `screen_ticker(ticker)` → full verdict with evidence citations ·\n`screening_methodology()` → the methodology summary.\nAnonymous use: 10 req/min per IP. With an `X-API-Key` header: 30+ req/min.\n\n## REST quickstart\n\n```bash\n# No key needed (demo tier, 10 req/min):\ncurl https://daleel.o11r.com/v1/screen/MSFT\n\n# Free key (30 req/min, batch + history):\ncurl -X POST https://daleel.o11r.com/api/keys \\\n  -H \"Content-Type: application/json\" -d '{\"email\": \"you@example.com\"}'\n\ncurl https://daleel.o11r.com/v1/screen/MSFT -H \"X-API-Key: YOUR_KEY\"\n```\n\nThe response includes a per-methodology audit matrix (every ratio vs every\nthreshold), an evidence ledger with sec.gov links, purification percentages,\nand — with `?overlays=all` — values/ESG screens sourced from official\ngovernment lists (UFLPA, DoD 1260H, state divestment lists), each with its\ncitation. See [examples/](examples/) for Python and JavaScript.\n\n## Principles\n\n- **Missing data is never treated as compliant.** Unscreenable → says so.\n- **Every approximation is disclosed** in the response itself.\n- **Verdicts are methodology calculations**, not religious rulings; consult a\n  qualified scholar for matters of fiqh. Nothing here is investment advice.\n\n## Links\n\n- OpenAPI: https://daleel.o11r.com/openapi.json\n- llms.txt: https://daleel.o11r.com/llms.txt\n- Why we built this: https://daleel.o11r.com/blog/why-my-trading-bot-made-nothing\n- Contact: daleel@o11r.com\n",
  "bytes": 2324,
  "sha": "6f67462a4cc1a86693bd9040d516225c6611f65c5b988f33c88f495aca528340",
  "repo_slug": "obedier/daleel",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_o11r_daleel_f87f827f/readme"
}