بنیادی اعداد، تناسب، مالی گوشوارے اور ڈیویڈنڈ — ساتھ AAOIFI تعمیل فیصلہ — ایک REST کال یا ایک MCP ٹول سے۔ ہر عدد متعدد آزاد ذرائع (SEC EDGAR، Yahoo، Finnhub) سے کراس-تصدیق شدہ؛ دو سے کم ذرائع والی کوئی بھی چیز غیر تصدیق شدہ نشان زد۔ خلیجی اور امریکی مارکیٹس، 7 زبانیں، ایجنٹ-نیٹیو۔

مفت اکاؤنٹ کے ساتھ 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()