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
เซิร์ฟเวอร์ที่เกี่ยวข้อง
Chromium CodeSearch Tools
Search Chromium source code using advanced Code Search syntax.
National Parks
Access real-time information about U.S. National Parks, including park details, alerts, and activities, via the National Park Service (NPS) API.
Reexpress
Enable Similarity-Distance-Magnitude statistical verification for your search, software, and data science workflows
Naver Search
Search across various Naver services and analyze data trends using the Naver Search and DataLab APIs.
Unreal Engine Knowledge Graph
Search concept relationships in the Unreal Engine official documentation using a Neo4j-powered knowledge graph.
Langflow Document Q&A Server
A document question-and-answer server powered by Langflow.
Open Data Spain MCP
MCP that unifies access to the main Spanish open data sources (BOE, INE, AEMET, Datos.gob.es)
MCP Omnisearch
Unified access to multiple search providers and AI tools like Tavily, Perplexity, Kagi, Jina AI, Brave, and Firecrawl.
Ticketmaster
Discover events, venues, and attractions using the Ticketmaster Discovery API.
OpenAI WebSearch
Provides web search functionality for AI assistants using the OpenAI API, enabling access to up-to-date information.