LabscoMCP early access ↗
goww7MCP SERVER · OFFICIAL PROJECT

Halal Terminal MCP

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

by goww7 ↗Equity & Fund Market Data✓ Official

LABSCO 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

See installation options