Halalterminal MCP Server

Halal Terminal MCP server — 22 tools: screen stocks/ETFs across 5 Shariah methodologies (AAOIFI, DJIM, FTSE, MSCI, S&P), audit portfolios, calculate

Remote serverstreamable-httpPython

What is the Halalterminal MCP Server?

Halal Terminal MCP server — 22 tools: screen stocks/ETFs across 5 Shariah methodologies (AAOIFI, DJIM, FTSE, MSCI, S&P), audit portfolios, calculate zakat and

What the server does

The official Model Context Protocol server for Halal Terminal. Give your AI agent 22 tools to answer Islamic-finance questions: screen any stock or ETF across 5 methodologies (AAOIFI, DJIM, FTSE, MSCI, S&P), audit portfolios, calculate zakat and dividend purification, and pull live market data, news and SEC filings. Works inside Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Continue, Zed, Goose, and any other MCP client.

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.

  • 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

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Halalterminal MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
HALALTERMINAL_API_KEYDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Halalterminal MCP to Category.”
  • “Use Halalterminal MCP to Screening.”
  • “Use Halalterminal MCP to Comparison.”

Frequently asked questions

Halal Terminal MCP server — 22 tools: screen stocks/ETFs across 5 Shariah methodologies (AAOIFI, DJIM, FTSE, MSCI, S&P), audit portfolios, calculate zakat and Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.