Halal Terminal

Name: Halal Terminal
Author: goww7

by goww7version 1.0.0i★ –iComputer or cloud

Registry namecom.halalterminal/mcp

Install

Overview

Description from the maker (original English)

Shariah-compliant stock and ETF screening across AAOIFI, DJIM, FTSE, MSCI and S&P methodologies.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Computer or cloud
Transport: stdio, SSE
Category: Other
You need to fill in: HALALTERMINAL_API_KEY, X-API-Key

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on the maker’s server: what you ask it goes through their server.
You fill in yourself: HALALTERMINAL_API_KEY, X-API-Key

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

Runs in the cloudNothing to install; it connects over the internet
npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Or run it on your computer

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

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

Run this in your terminal

claude mcp add --transport sse halalterminal https://mcp.halalterminal.com/sse --header 'X-API-Key: your-value'

Or run it on your computer

claude mcp add halalterminal --env HALALTERMINAL_API_KEY=your-value -- npx -y @halalterminal/mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "halalterminal": {
      "url": "https://mcp.halalterminal.com/sse",
      "headers": {
        "X-API-Key": "your-value"
      }
    }
  }
}

Or run it on your computer

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

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

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "halalterminal": {
      "type": "sse",
      "url": "https://mcp.halalterminal.com/sse",
      "headers": {
        "X-API-Key": "your-value"
      }
    }
  }
}

Or run it on your computer

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "halalterminal": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@halalterminal/mcp"
      ],
      "env": {
        "HALALTERMINAL_API_KEY": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This address needs a key in a request header, which the add-connector menu cannot set. Use Claude Code, Cursor or VS Code instead.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

HALALTERMINAL_API_KEY secret required env
Halal Terminal API key (prefix ht_). Free tier available at https://api.halalterminal.com — email-only signup, no credit card.
X-API-Key secret required HTTP header
Halal Terminal API key (prefix ht_). Free tier available at https://api.halalterminal.com — email-only signup, no credit card.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

We have not read this server’s tool list yet; we check endpoints in rotation.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified against the domain halalterminal.com (the registry checks domain ownership)
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
… Not checked yet
Endpoint responds
Not checked yet; we check endpoints in rotation
… Not checked yet
Sign-in with OAuth
Not checked yet; we check endpoints in rotation
… Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint

Compared with others in Otheri

More stars than 0% of the other 32564 servers in this category
Published to the registry more recently than 9% of the other 32564 servers in this category
Basic checks equal to or better than 100% of the other 32564 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Halal Terminal safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: HALALTERMINAL_API_KEY, X-API-Key

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed –, and the latest version (1.0.0) reached the registry 6 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, Tools MCP

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Runs on your computer★ 440MITUpdated 14 months ago

Install

Remote Desktop Commander

by desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Runs in the cloud★ 211Updated yesterday

Install

Tools MCP

by First-CH

Web production tools for AI agents: contrast, JP text, WebP, JSON-LD, slugs, dates and 40+ more

Runs on your computerUpdated today

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Halal Terminal MCP — Shariah-compliant stock & ETF screening for AI agents

English | العربية | Bahasa Indonesia | Melayu | اردو | Français

_live badge from the API, embed one for any symbol_

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.

*"Is AAPL halal?"* · *"Audit my portfolio: AAPL 30%, MSFT 20%, JNJ 50%"* · *"Calculate zakat on my holdings."*

Quick start

Get a free API key — email-only signup at api.halalterminal.com. No credit card. Key arrives in your inbox in seconds.
Connect your client — one-liners below (or see CONNECT.md for Cursor, Windsurf, Cline, and others).
Ask your first question — "Is AAPL halal?" → the agent calls screen_stock and returns verdicts across all 5 methodologies.

Install

# Recommended — no install needed

npx -y @halalterminal/mcp

Or pin globally

npm install -g @halalterminal/mcp

Claude Desktop

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

Claude Code

claude mcp add --transport sse halalterminal \

https://mcp.halalterminal.com/sse \ --header "X-API-Key: ht_yourkey"

Cursor / Windsurf / direct SSE

https://mcp.halalterminal.com/sse?api_key=ht_yourkey

Full setup guide for all clients: CONNECT.md.

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`

Full input/output reference in TOOLS.md. End-to-end prompt walkthroughs in EXAMPLES.md.

Why Halal Terminal

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.

Endpoint & transport

SSE: https://mcp.halalterminal.com/sse

Auth: X-API-Key: (or ?api_key= )

Transports supported: SSE (recommended), stdio (via this @halalterminal/mcp bridge for clients that need it).

Plans & quotas

The Halal Terminal API is token-metered, not request-metered.

Plan	Monthly tokens	Price	Notes
Free	50	$0	~5–10 full screenings · email signup, no credit card
Starter	2,500	$19	Individual investors
Pro	15,000	$49	Webhooks, bulk priority
Enterprise	Unlimited	$199+	Custom methodologies, SLA

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

FAQ

Is this MCP server free to use?

Yes. The @halalterminal/mcp package 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.

Which AI clients does it work with?

Any client that supports the Model Context Protocol over SSE or stdio — Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Continue, Zed, Goose, and more. SSE is recommended; the @halalterminal/mcp package wraps it as stdio for clients that don't yet support SSE.

How is "halal" determined?

Each verdict applies the published rules of the chosen methodology — AAOIFI, Dow Jones Islamic Market (DJIM), FTSE Shariah, MSCI Islamic, and S&P Shariah. Two layers: (1) a business-activity screen (no alcohol, gambling, conventional finance, adult content, weapons, pork, …), then (2) financial-ratio thresholds (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.

What is dividend purification?

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.

Can it screen ETFs?

Yes — screen_etf walks 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).

Can I screen an entire index at once?

Yes — bulk_screen triggers 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.

Does it support webhooks for compliance changes?

Webhooks are a Pro-plan feature on the API roadmap; v1 of this MCP is request-response only.

Where do I report bugs or request tools?

github.com/goww7/halalterminal-mcp/issues or email yassir@halalterminal.com.

Learn more

Part of the Halal Terminal ecosystem

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

Related projects (sibling OSS)

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

Project	What it is	License
halalterminal-claude-skills	Claude Code plugin — curated skills, slash commands, and a portfolio-builder subagent on top of this MCP server.	Apache-2.0
yassir-oss	Open-source ReAct agent for halal finance research — CLI + web UI; supports OpenAI / Anthropic / local LLMs.	Apache-2.0
halal-discord-bot	Discord bot — `/halal AAPL`, `/portfolio`, `/trending` slash commands.	MIT
halal-portfolio-tracker	Next.js 14 app — enter holdings, get per-stock compliance + portfolio halal % + purification owed. One-click Vercel deploy.	MIT
halal-pine	TradingView Pine Script v5 indicator that overlays compliance status on charts. Refreshed daily from this API.	MIT

License & trademarks

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: yassir@halalterminal.com
Dashboard: api.halalterminal.com/dashboard
API docs: api.halalterminal.com/docs (Swagger) · api.halalterminal.com/redoc (ReDoc)

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

Halal Terminal

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Or run it on your computer

Or run it on your computer

Or run it on your computer

Or run it on your computer

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

Tools MCP

README from the maker

Halal Terminal MCP — Shariah-compliant stock & ETF screening for AI agents

Quick start

Install

Or pin globally

Claude Desktop

Claude Code

Cursor / Windsurf / direct SSE

What you get — 22 tools across 8 categories

Why Halal Terminal

Endpoint & transport

Plans & quotas

What this MCP server is NOT

FAQ

Is this MCP server free to use?

Which AI clients does it work with?

How is "halal" determined?

What is dividend purification?

Can it screen ETFs?

Can I screen an entire index at once?

Does it support webhooks for compliance changes?

Where do I report bugs or request tools?

Learn more

Part of the Halal Terminal ecosystem

Related projects (sibling OSS)

License & trademarks

Legal

Support