Halal Terminal MCP

SSE

by goww7

203 downloads Not rated yet

About

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.

Details

Transport
SSE

Explore

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Halal Terminal MCP
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

Full input/output reference in](https://github.com/goww7/halalterminal-mcp/blob/HEAD/CONNECT.md)TOOLS.md. End-to-end prompt walkthroughs inEXAMPLES.md.

- 5 methodologies, one tool.AAOIFI, DJIM, FTSE Shariah, MSCI Islamic, and S&P Shariah — each with distinct business-activity rules and financial-ratio thresholds — surfaced side-by-side per stock so users pick the standard they follow.
- Holdings-level ETF screening.Every constituent is screened, weighted, and aggregated into an overall verdict plus a per-dollar purification rate. Covers SPY, QQQ, VTI, ISDU, SPUS, HLAL, and 8,000+ ETFs.
- Zakat & purification, computed.2.5% zakat against a live nisab threshold; per-dividend impure-income calculation based on the issuer's non-compliant revenue ratio.
- Bulk index screens.Trigger-and-poll runs on the S&P 500, NASDAQ-100, FTSE 100, and others; filter by methodology, sector, or compliant-only.
- Free tier, no credit card.Email signup → key in your inbox in seconds → ~5–10 full screens per month at no cost.

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/mcpbridge for clients that need it).

The Halal Terminal API istoken-metered, not request-metered.

Sign up:api.halalterminal.com· Pricing:halalterminal.com/pricing

- 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; webhook-driven alerts are on the Pro+ roadmap.
- English-only in v1.Arabic + French rendering is on the roadmap.

Yes. The@halalterminal/mcppackage is Apache-2.0 and free. The Halal Terminal API has a free tier (500 tokens / month, no credit card) that covers ~100 full stock screenings — enough to evaluate it before upgrading.

Any client that supports the Model Context Protocol overSSEorstdio— Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Continue, Zed, Goose, and more. SSE is recommended; the@halalterminal/mcppackage 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, andS&P Shariah. Two layers: (1) abusiness-activityscreen (no alcohol, gambling, conventional finance, adult content, weapons, pork, …), then (2)financial-ratiothresholds (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", …)andget_dividends(include_purification=True)compute that amount automatically.

Yes —screen_etfwalks 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_screentriggers 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.

github.com/goww7/halalterminal-mcp/issuesor email[email protected].

- API reference
-
Building an Islamic finance MCP server
-
What is Islamic finance?
-
Sukuk screening guide
-
Is my stock halal? Screener

Website·API·Python SDK·JS SDK·Claude plugin·Discord bot·TradingView indicator·Portfolio tracker

Open-source tools that share the same Halal Terminal API — different surfaces, same data:

"Halal Terminal", "HalalTerminal", and the Halal Terminal logo are reserved trademarks — seeTRADEMARKS.md.

- Contact:[email protected]
- Dashboard:
api.halalterminal.com/dashboard
- API docs:
api.halalterminal.com/docs(Swagger) ·api.halalterminal.com/redoc(ReDoc)

Powered by Halal Terminal —halalterminal.com

Part of theHalal Terminal open ecosystem:API·MCP server·Python SDK·JS SDK·Datasets·Awesome Islamic Finance

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

185 agent-payable C-suite intelligence tools — competitive intel, SEC filings, sanctions, KYC, clinical evidence, ESG. x402 USDC/EURC. 100 free calls/mo.

Provides comprehensive enterprise risk analysis, including violation records, mortgage information, business anomalies, and judicial cases.

Company lookup, LEI search, SEC filings, and financials for AI agents. 6 tools, free, no API key.

SEC filings and insider trades in real-time. 10-K, 10-Q, 8-K, Form 4, and company lookup.

Provides real-time crypto and Web3 intelligence using the Hive Intelligence API.

Look up companies, board members, and business roles across Norway, Denmark, Finland, and Sweden's official business registries.

orean corporate disclosure & financial data from DART (금융감독원 전자공시시스템). Search companies, filings, and financial statements via OpenDART API.

Unmodified government company registry data — 27 national registries, live. Cross-border UBO / beneficial owner chain walker for KYC, AML, due diligence. 27 tools + 10 MCP prompt workflows.

Market briefings for AI agents with trend signals, regime classification, and confidence scores across Bitcoin, macro, FX, and cross-asset data.

Access to insider trading data, SEC filings, economic indicators, and multi-signal analysis

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "halal terminal mcp": {
            "server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@halalterminal/mcp"
                ],
                "env": {
                    "HALALTERMINAL_API_KEY": ""
                }
            }
        }
    }
}

McpServers

{
    "server": {
        "command": "npx",
        "args": [
            "-y",
            "@halalterminal/mcp"
        ],
        "env": {
            "HALALTERMINAL_API_KEY": ""
        }
    }
}

Transport

"stdio"

Package

"@halalterminal/mcp"

Registry

"npm"
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.