Halal Terminal MCP
Shariah-compliant investing for AI agents — screen stocks & ETFs across 5 methodologies (AAOIFI, DJIM, FTSE, MSCI, S&P), audit portfolios, calculate zakat, get market data, news & SEC filings.
Halal Terminal MCP
The official Model Context Protocol server for Halal Terminal — Shariah-compliant investing capabilities for AI agents.
Screen stocks and ETFs across 5 methodologies (AAOIFI, DJIM, FTSE, MSCI, S&P), audit portfolios, calculate zakat and dividend purification, fetch market data, news, and SEC filings — directly from any MCP-compatible client (Claude Desktop, Claude Code, Cursor, Windsurf, …).
What you get
22 tools across 8 categories:
| 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 |
See TOOLS.md for full input/output reference.
Quick start
- Get a free API key at https://api.halalterminal.com (email → key in your inbox, no credit card).
- Connect your MCP client — see CONNECT.md for Claude Desktop, Claude Code, Cursor, Windsurf, and direct SSE.
- Ask your assistant — "Is AAPL halal?", "Audit my portfolio: AAPL 30%, MSFT 20%, JNJ 50%", "Calculate zakat on my holdings."
For end-to-end examples, see EXAMPLES.md.
Endpoint
https://mcp.halalterminal.com/sse
- Transport: SSE (Server-Sent Events). A stdio bridge snippet is provided in CONNECT.md for clients that require stdio.
- Auth:
X-API-Key: <your_key>header (or?api_key=<your_key>query param). - Rate limits: per-plan token quotas, see below.
Plans and quotas
The Halal Terminal API is token-metered.
| Plan | Monthly tokens | Price | Note |
|---|---|---|---|
| Free | 50 | $0 | ~5–10 full screenings |
| Starter | 2,500 | $19 | for individual investors |
| Pro | 15,000 | $49 | webhooks, bulk priority |
| Enterprise | Unlimited | $199+ | custom methodologies, SLA |
Sign up: https://api.halalterminal.com
What this MCP server is NOT
- Not a fatwa. Every verdict is a methodology-based screening. Consult a qualified scholar for personal rulings.
- Not a trading platform. No broker integrations, no order execution.
- Not a real-time alert system. Request-response only in v1 (webhooks coming in v2 for Pro+ users).
- Not a multi-language tool. English responses only in v1.
Related projects
- halalterminal-claude-skills — Claude Code plugin with curated skills, slash commands, and a portfolio-builder subagent that wraps this MCP server with task-specific guidance.
License
Apache-2.0 — see LICENSE.
"Halal Terminal", "HalalTerminal", and the Halal Terminal logo are reserved trademarks — see TRADEMARKS.md.
Legal
- Legal & Disclaimer — educational-research framing, investment disclaimer, Shariah compliance notice, liability limits, jurisdiction notices
- Privacy Policy
- Cookie Policy
Support
- Contact: [email protected]
- Dashboard: https://halalterminal.com/dashboard
- API docs: https://api.halalterminal.com/docs (Swagger) · https://api.halalterminal.com/redoc (ReDoc)
Powered by Halal Terminal — https://halalterminal.com
Serveurs connexes
Brave Search
An MCP server for the Brave Search API, providing web and local search capabilities via a streaming SSE interface.
SearXNG Bridge
A bridge server for connecting to a SearXNG metasearch engine instance.
MCP-NixOS
A server for searching NixOS, Home Manager, and nix-darwin resources.
VelociRAG
Lightning-fast RAG for AI agents. 4-layer fusion (vector, BM25, graph, metadata), ONNX Runtime, sub-200ms search, no PyTorch.
Hunter.io
Find and verify professional email addresses with the Hunter.io API.
PBS API
Access Australian Pharmaceutical Benefits Scheme data for medicine information, pricing, and availability. Built with Python and FastAPI.
독립유공자 공훈록
Query records of Korean independence activists from the Ministry of Patriots and Veterans Affairs.
Semble
Fast, accurate, local code search for agents. Indexes any local path or GitHub repo on demand in ~250ms and answers queries in ~1.5ms. Works on CPU, no API keys or external services.
Research Task
An AI-powered research assistant that can investigate any topic using an interactive configuration wizard.
Expert Registry MCP Server
An MCP server for expert discovery, registration, and context injection, utilizing vector and graph databases.