HalalStock MCP server

An MCP server for halal (Sharia-compliant) stock screening. Ask your AI agent "Is Apple halal?" and get a structured verdict — across US, Gulf, and global markets — powered by halalstock.net and based on AAOIFI Standard 21.

Tools

Tool	What it does
check_halal(symbol, profile)	Verdict (halal / not halal / questionable), 0–100 compliance score, the AAOIFI financial ratios, a confidence level, and a plain-language explanation. ETFs get a holdings look-through.
screen_portfolio(symbols, profile)	Screen up to 25 tickers at once with a summary.
search_stocks(query, limit)	Find a ticker by company name or keyword.

profile is "standard" (core scholarly consensus) or "strict".

Install

git clone https://github.com/moekamel94/halalstock-mcp.git
cd halalstock-mcp
pip install -r requirements.txt

Use with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "halalstock": {
      "command": "python",
      "args": ["/absolute/path/to/halalstock-mcp/server.py"]
    }
  }
}

Then ask Claude: "Use halalstock to check if NVDA, JPM and Aramco are halal."

Optional: higher rate limits

The free tier works with no key. For higher limits, get a free API key at https://halalstock.net/#signup and set it:

      "env": { "HALALSTOCK_API_KEY": "thl_your_key" }

Notes

• Screening analysis is informational only — not a fatwa or financial advice. Always confirm with a qualified scholar. See the methodology.
• Covers US, Saudi/Gulf, and international stocks + ETFs. Data via the HalalStock API.

License

MIT