Labsco
MCP SERVER

Halal Terminal MCP

by goww7 ↗

Screen a stock or ETF against five Shariah methodologies, audit a portfolio, and compute zakat and dividend purification.

Equity & Fund Market Data
Summary
Five verdicts, not one, and it says plainly that it is not a fatwa.

The design decision that matters is returning all five methodologies side by side instead of picking one: which standard applies is the user's call or their scholar's, and collapsing them would hide the disagreement. The project is equally clear about its limits — a screening is not a religious ruling, there is no order execution, and this version does not alert.

What it is

The official MCP server for Halal Terminal, giving an agent 22 tools for Islamic-finance questions. Verdicts apply the published rules of AAOIFI, Dow Jones Islamic Market, FTSE Shariah, MSCI Islamic and S&P Shariah — a business-activity screen first, then financial-ratio thresholds — and all five are returned side by side.

What you get
  • A stock or ETF screened across all 5 methodologies, in bulk over an index, with results retrievable afterwards — `screen_stock`, `screen_etf`, `bulk_screen`, `get_screening_result`, `get_all_screening_results`
  • Market data: quotes, company info, price history, trending stocks and symbol search — `get_quote`, `get_stock_info`, `get_price_history`, `get_trending_stocks`, `search_stocks`
  • ETF analysis down to the holdings, with an aggregate purification rate and side-by-side comparison — `get_etf_info`, `etf_purification`, `compare_etfs`
  • A whole portfolio scanned, and a watchlist maintained — `scan_portfolio`, `manage_watchlist`
  • Stocks compared head to head — `compare_stocks`
  • Dividends with their impure-income fraction, and zakat at 2.5% against a live nisab threshold — `get_dividends`, `calculate_zakat`
  • News and SEC filings for a symbol — `get_news`, `get_sec_filings`
  • A generated report, and explanations of the Islamic-finance terms behind a verdict — `generate_report`, `islamic_finance_education`
Requirements

A Halal Terminal API key with an `ht_` prefix, from an email-only signup with no credit card. Two ways in: connect directly to `https://mcp.halalterminal.com/sse` with the key in an `X-API-Key` header, or run the stdio bridge with `npx -y @halalterminal/mcp` and `HALALTERMINAL_API_KEY` in the environment. Billing is token-metered rather than per request — the free plan carries 50 monthly tokens, roughly 5–10 full screenings; Starter is $19 for 2,500 and Pro $49 for 15,000. Version 1 is request-response only, with no webhooks or alerts, and output is English.

Setup effort

One command plus a key — npx -y @halalterminal/mcp, then supply credentials