Halal Terminal MCP server

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

1. Get a free API key — email-only signup at api.halalterminal.com. No credit card. Key arrives in your inbox in seconds.
2. Connect your client — one-liners below (or see CONNECT.md for Cursor, Windsurf, Cline, and others).
3. 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

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

Why Halal Terminal

Shortened. The full README is on GitHub.