goww7 avatar

Halal Terminal

goww7/halalterminal-mcp

Connects Claude to Halal Terminal's Islamic finance API with 22 tools spanning stock and ETF screening, zakat calculation, dividend purification, and portfolio audits. Covers five methodologies (AAOIFI, DJIM, FTSE, MSCI, S&P) so you can surface verdicts across standards in a single call. Screen individual tickers, bulk scan indices like the S&P 500, or walk ETF holdings to compute weighted compliance and purification rates. Includes live quotes, SEC filings, and news. Free tier gives you 50 tokens per month (roughly 5–10 full screens) with no credit card. Reach for this when building investment tools for Muslim users or when you need programmatic access to Shariah screening logic without rolling your own ratio and business activity checks.

GitHub stars
1
tools
22
auth
Secret needed
transport
STDIO, SSE
env var
1
last updated
May 10, 2026

Tools

22 tools

Public tool metadata for what this MCP can expose to an agent.

screen_stockScreen a stock for Shariah compliance across all 5 methodologies.

Screen a stock for Shariah compliance across all 5 methodologies.

No parameter schema in public metadata yet.

screen_etfScreen an ETF by walking every underlying holding and returning an overall verdict, compliant percentage, and aggregate purification rate.

Screen an ETF by walking every underlying holding and returning an overall verdict, compliant percentage, and aggregate purification rate.

No parameter schema in public metadata yet.

bulk_screenTrigger an asynchronous screening run on an index such as S&P 500, NASDAQ-100, or FTSE 100, with polling and filters.

Trigger an asynchronous screening run on an index such as S&P 500, NASDAQ-100, or FTSE 100, with polling and filters.

No parameter schema in public metadata yet.

get_screening_result

No parameter schema in public metadata yet.

get_all_screening_results

No parameter schema in public metadata yet.

get_quote

No parameter schema in public metadata yet.

get_stock_info

No parameter schema in public metadata yet.

get_price_history

No parameter schema in public metadata yet.

get_trending_stocks

No parameter schema in public metadata yet.

search_stocks

No parameter schema in public metadata yet.

get_etf_info

No parameter schema in public metadata yet.

etf_purification

No parameter schema in public metadata yet.

compare_etfs

No parameter schema in public metadata yet.

scan_portfolioAudit a portfolio of holdings for compliance and halal percentage.

Audit a portfolio of holdings for compliance and halal percentage.

No parameter schema in public metadata yet.

manage_watchlist

No parameter schema in public metadata yet.

compare_stocks

No parameter schema in public metadata yet.

get_dividendsRetrieve dividends, optionally with purification amounts.

Retrieve dividends, optionally with purification amounts.

No parameter schema in public metadata yet.

calculate_zakatCalculate zakat on holdings or dividend purification.

Calculate zakat on holdings or dividend purification.

No parameter schema in public metadata yet.

get_news

No parameter schema in public metadata yet.

get_sec_filings

No parameter schema in public metadata yet.

generate_report

No parameter schema in public metadata yet.

islamic_finance_education

No parameter schema in public metadata yet.

Sponsors

Configuration

HALALTERMINAL_API_KEY*secret

Halal Terminal API key (prefix ht_). Free tier available at https://api.halalterminal.com — email-only signup, no credit card.

Readme

Halal Terminal MCP — Shariah-compliant stock & ETF screening for AI agents

English | العربية | Bahasa Indonesia | Melayu | اردو | Français

AAPL halal status live badge from the API, embed one for any symbol

npm version Apache 2.0 MCP Powered by Halal Terminal


View the full README on GitHub

Details

Repository
github.com/goww7/halalterminal-mcp
Website
halalterminal.com
Package
@halalterminal/mcp
Transport
STDIO, SSE
Auth
Required
Registry
MCP registry, active

More from goww7