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
Related Servers
Fish MCP Server
Search for fish species using the FishBase database. Supports natural language queries in both Japanese and English.
MCP Omnisearch
Unified access to multiple search providers and AI tools like Tavily, Perplexity, Kagi, Jina AI, Brave, and Firecrawl.
mcpdoc
Access website documentation for AI search engines (llms.txt files) over MCP.
Open Custom Search API
Perform web searches using Google's Custom Search API.
Shodan MCP Server
Query internet-connected devices, services, and vulnerabilities using the Shodan API and CVE database.
Xiaohongshu XHS RedNote Social Media Data Assistant MCP
Read-only Xiaohongshu / XHS / RedNote MCP for note search, note details, paginated comments, creator profiles, and creator note lists.
Hugeicons MCP Server
Search for icons from the Hugeicons library and get usage documentation.
OSRS MCP Server
Search the Old School RuneScape (OSRS) Wiki and access game data definitions.
展会大数据服务
Query comprehensive exhibition information, including enterprise participation records, venue details, and exhibition search.
People Data Labs
Access person, company, school, location, job title, and skill data using the People Data Labs API.