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 MCP server?

If you already use Halalterminal MCP, the halalterminal mcp mcp server is the piece that lets your assistant work with it directly. Halal Terminal MCP server — 22 tools: screen stocks/ETFs across 5 Shariah methodologies (AAOIFI, DJIM, FTSE, MSCI, S&P), audit portfolios, calculate zakat and purification, fetch market data and SEC filings. For Claude, Cursor, Windsurf.

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

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • Category — Tools
  • Screening — screen_stock, screen_etf, bulk_screen, get_screening_result, get_all_screening_results
  • Comparison — compare_stocks

Credentials and setup notes

Configuration is passed through the environment: HALALTERMINAL_API_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Installation

Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.

Where it fits

Among the team communication options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Halalterminal MCP's toolset — Category, Screening, Comparison — is a fair guide to whether it matches your workflow. It is maintained by goww7; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Worth knowing first

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
CategoryTools
Screeningscreen_stock, screen_etf, bulk_screen, get_screening_result, get_all_screening_results
Comparisoncompare_stocks

How to install the Halalterminal MCP MCP server

### Claude Desktop

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

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
HALALTERMINAL_API_KEYCredential the server authenticates with.Yes

Example prompts to try

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

Frequently asked questions

It connects Halalterminal MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 3 tools (Category, Screening, Comparison) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Halalterminal MCP directly.