Server data from the Official MCP Registry
Shariah-compliant stock and ETF screening across AAOIFI, DJIM, FTSE, MSCI and S&P methodologies.
Shariah-compliant stock and ETF screening across AAOIFI, DJIM, FTSE, MSCI and S&P methodologies.
Remote endpoints: sse: https://mcp.halalterminal.com/sse
This is a well-structured MCP server bridge with proper authentication and minimal code. The server acts as a proxy between local AI clients and the Halal Terminal API, with API key validation and secure credential handling via environment variables. No security vulnerabilities, malicious patterns, or dangerous code detected. Permissions are appropriate for its purpose. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.
3 files analyzed · 6 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: HALALTERMINAL_API_KEY
Available as Local & Remote
This plugin can run on your machine or connect to a hosted endpoint. during install.
From the project's GitHub README.
The official Model Context Protocol server for Halal Terminal. Screen any stock or ETF for Shariah (Islamic) compliance across 5 methodologies — AAOIFI, DJIM, FTSE, MSCI, S&P — audit portfolios, calculate zakat and dividend purification, and pull market data, news and SEC filings, all from inside any MCP-compatible AI agent: Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Continue, Zed, Goose, and more.
"Is AAPL halal?" · "Audit my portfolio: AAPL 30%, MSFT 20%, JNJ 50%" · "Calculate zakat on my holdings."
# Recommended — npx (no install)
npx -y @halalterminal/mcp
# Or pin globally
npm install -g @halalterminal/mcp
Then get a free API key at api.halalterminal.com (email-only signup, no credit card) and follow CONNECT.md for your client.
{
"mcpServers": {
"halalterminal": {
"command": "npx",
"args": ["-y", "@halalterminal/mcp"],
"env": { "HALALTERMINAL_API_KEY": "ht_yourkey" }
}
}
}
claude mcp add --transport sse halalterminal \
https://mcp.halalterminal.com/sse \
--header "X-API-Key: ht_yourkey"
https://mcp.halalterminal.com/sse?api_key=ht_yourkey
Full client guide: CONNECT.md.
| Category | Tools |
|---|---|
| Screening | screen_stock, screen_etf, bulk_screen, get_screening_result, get_all_screening_results |
| Market data | get_quote, get_stock_info, get_price_history, get_trending_stocks, search_stocks |
| ETF analysis | get_etf_info, etf_purification, compare_etfs |
| Portfolio & watchlist | scan_portfolio, manage_watchlist |
| Comparison | compare_stocks |
| Income & zakat | get_dividends, calculate_zakat |
| News & filings | get_news, get_sec_filings |
| Reports & education | generate_report, islamic_finance_education |
Full input/output reference in TOOLS.md. End-to-end prompt walkthroughs in EXAMPLES.md.
SSE: https://mcp.halalterminal.com/sse
Auth: X-API-Key: <your_key> (or ?api_key=<your_key>)
Transports supported: SSE (recommended), stdio (via this @halalterminal/mcp bridge for clients that need it).
The Halal Terminal API is token-metered, not request-metered.
| Plan | Monthly tokens | Price | Notes |
|---|---|---|---|
| Free | 50 | $0 | ~5–10 full screenings · email signup, no credit card |
| Starter | 2,500 | $19 | Individual investors |
| Pro | 15,000 | $49 | Webhooks, bulk priority |
| Enterprise | Unlimited | $199+ | Custom methodologies, SLA |
Sign up: api.halalterminal.com · Pricing: halalterminal.com/pricing
Yes. The @halalterminal/mcp package is Apache-2.0 and free. The Halal Terminal API has a free tier (50 tokens / month, no credit card) that covers ~5–10 full stock screenings — enough to evaluate it before upgrading.
Any client that supports the Model Context Protocol over SSE or stdio — Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Continue, Zed, Goose, and more. SSE is recommended; the @halalterminal/mcp package wraps it as stdio for clients that don't yet support SSE.
Each verdict applies the published rules of the chosen methodology — AAOIFI, Dow Jones Islamic Market (DJIM), FTSE Shariah, MSCI Islamic, and S&P Shariah. Two layers: (1) a business-activity screen (no alcohol, gambling, conventional finance, adult content, weapons, pork, …), then (2) financial-ratio thresholds (e.g. interest-bearing debt over market cap, illiquid assets, interest income share). The MCP exposes all five verdicts so the user — or scholar — can pick the standard they follow.
When you hold a stock with a small share of non-compliant revenue, scholars require donating the non-compliant fraction of any dividend received. calculate_zakat(calculation_type="purification", …) and get_dividends(include_purification=True) compute that amount automatically.
Yes — screen_etf walks every underlying holding, applies the methodology to each, and returns an overall verdict, compliant percentage, and aggregate purification rate. Sukuk ETFs are handled separately (asset-based methodologies).
Yes — bulk_screen triggers an asynchronous run on indices like S&P 500, NASDAQ-100, FTSE 100, and lets you poll for status, filter results by methodology / sector / compliant-only, and diff two runs.
Webhooks are a Pro-plan feature on the API roadmap; v1 of this MCP is request-response only.
github.com/goww7/halalterminal-mcp/issues or email yassir@halalterminal.com.
Open-source tools that share the same Halal Terminal API — different surfaces, same data:
| Project | What it is | License |
|---|---|---|
| halalterminal-claude-skills | Claude Code plugin — curated skills, slash commands, and a portfolio-builder subagent on top of this MCP server. | Apache-2.0 |
| yassir-oss | Open-source ReAct agent for halal finance research — CLI + web UI; supports OpenAI / Anthropic / local LLMs. | Apache-2.0 |
| halal-discord-bot | Discord bot — /halal AAPL, /portfolio, /trending slash commands. | MIT |
| halal-portfolio-tracker | Next.js 14 app — enter holdings, get per-stock compliance + portfolio halal % + purification owed. One-click Vercel deploy. | MIT |
| halal-pine | TradingView Pine Script v5 indicator that overlays compliance status on charts. Refreshed daily from this API. | MIT |
Apache-2.0 — see LICENSE.
"Halal Terminal", "HalalTerminal", and the Halal Terminal logo are reserved trademarks — see TRADEMARKS.md.
Powered by Halal Terminal — halalterminal.com
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.