بيانات أساسية ونسب وقوائم مالية وأرباح — مع نتيجة توافق وفق آيوفي — من طلب REST واحد أو أداة MCP واحدة. كل رقم مدقّق عبر عدة مصادر مستقلة (SEC EDGAR وYahoo وFinnhub)، وأي رقم بأقل من مصدرين يُعلَّم كغير موثَّق. أسواق الخليج وأمريكا، بسبع لغات، ومصمّمة للوكلاء.

مجاناً لمدة 3 أشهر مع حساب مجاني — وصول كامل لكل فحص وأدوات الزكاة وواجهة API وخادم MCP. بدون بطاقة؛ تبدأ الخطط المدفوعة بعد فترة الإطلاق. تسميات الخطط في الجدول أدناه تُظهر التسعير المستقبلي؛ لا تُفرض أي رسوم خلال فترة الإطلاق.

أنشئ حسابك المجاني ملف مهارة الوكيل

import { HalalStock, HalalStockError } from "./halalstock.js";

// key from your account (starts with thl_); keyless works too but is IP-metered
const hs = new HalalStock(process.env.HALALSTOCK_API_KEY);

try {
  const v = await hs.check("AAPL");            // GET /v1/stock/AAPL/halal
  // status is a screening result, not a fatwa — read it with confidence
  console.log(v.status, v.compliance_score, v.confidence);
  console.log(v.disclaimer);                   // always relay this to the user

  const res = await hs.screen(["AAPL", "TSLA", "2222.SR"]);  // batch, up to 25
  console.log(res.count, "screened");
} catch (e) {
  if (e instanceof HalalStockError) console.error(e.status, e.detail);
}

# public — no key needed (metered per IP)
curl "https://halalstock.net/v1/stock/AAPL/halal?profile=standard"

# with your key (starts with thl_) for a higher quota
curl "https://halalstock.net/v1/stock/2222.SR/halal" \
  -H "Authorization: Bearer $HALALSTOCK_API_KEY"

# batch screen up to 25 tickers
curl "https://halalstock.net/v1/screen?symbols=AAPL,TSLA,2222.SR" \
  -H "Authorization: Bearer $HALALSTOCK_API_KEY"

# add to your MCP client config (e.g. Claude Desktop)
{
  "mcpServers": {
    "halalstock": {
      "command": "python",
      "args": ["-m", "tahleel.mcp_server"],
      "env": {
        "HALALSTOCK_API_URL": "https://halalstock.net",
        "HALALSTOCK_API_KEY": "thl_your_key"
      }
    }
  }
}
# then just ask: "Is Aramco (2222.SR) halal?" — the agent calls check_halal()