Halal Terminal

Halal Terminal MCP — AI エージェント向けのシャリーア準拠株式・ETFスクリーニング

英語 | アラビア語 | インドネシア語 | マレー語 | ウルドゥー語 | フランス語

APIから取得したライブバッジです。任意の銘柄のバッジを埋め込めます

Halal Terminalの公式Model Context Protocolサーバーです。AI エージェントに22個のツールを提供し、イスラム金融に関する質問に回答できます。5つの手法（AAOIFI、DJIM、FTSE、MSCI、S&P）であらゆる株式やETFをスクリーニングし、ポートフォリオを監査し、ザカートと配当の浄化を計算し、ライブ市場データ、ニュース、SEC提出書類を取得します。Claude Desktop、Claude Code、Cursor、Windsurf、Cline、Continue、Zed、Gooseなど、あらゆるMCPクライアントで利用できます。

「AAPLはハラールですか？」 · 「ポートフォリオを監査してください：AAPL 30%、MSFT 20%、JNJ 50%」 · 「保有資産のザカートを計算してください。」

クイックスタート

1. 無料のAPIキーを取得 — api.halalterminal.comでメールアドレスのみで登録できます。クレジットカードは不要です。キーは数秒で受信トレイに届きます。
2. クライアントを接続 — 以下のワンライナーを使うか、Cursor、Windsurf、ClineなどについてはCONNECT.mdをご覧ください。
3. 最初の質問をする — "Is AAPL halal?" → エージェントがscreen_stockを呼び出し、5つの手法すべての判定を返します。

インストール

# 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 / SSEへの直接接続

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

すべてのクライアントのセットアップガイド：CONNECT.md。

利用できる機能 — 8カテゴリにわたる22個のツール

カテゴリ	ツール
スクリーニング	screen_stock、screen_etf、bulk_screen、get_screening_result、get_all_screening_results
市場データ	get_quote、get_stock_info、get_price_history、get_trending_stocks、search_stocks
ETF分析	get_etf_info、etf_purification、compare_etfs
ポートフォリオとウォッチリスト	scan_portfolio、manage_watchlist
比較	compare_stocks
収入とザカート	get_dividends、calculate_zakat
ニュースと提出書類	get_news、get_sec_filings
レポートと学習	generate_report、islamic_finance_education

入力と出力の詳細はTOOLS.mdをご覧ください。プロンプトを使った一連の操作例はEXAMPLES.mdをご覧ください。

Halal Terminalを選ぶ理由

• 1つのツールで5つの手法に対応。 AAOIFI、DJIM、FTSE Shariah、MSCI Islamic、S&P Shariahに対応しています。それぞれ異なる事業活動のルールと財務比率のしきい値を採用しており、各株式について並べて表示するため、ユーザーは準拠する基準を選べます。
• ETFの保有銘柄レベルでスクリーニング。 すべての構成銘柄をスクリーニングして加重集計し、ETF全体の判定と、1ドル当たりの浄化率を算出します。SPY、QQQ、VTI、ISDU、SPUS、および8,000以上のETFに対応しています。
• ザカートと浄化を計算。 ライブのニサーブしきい値に基づく2.5%のザカートと、発行体の非準拠収益比率に基づく配当ごとの不浄所得額を計算します。
• インデックスの一括スクリーニング。 S&P 500、NASDAQ-100、FTSE 100などを対象に、実行後に結果を照会する方式で処理します。手法、セクター、または準拠銘柄のみで絞り込めます。
• クレジットカード不要の無料プラン。 メールアドレスで登録すると数秒で受信トレイにキーが届き、毎月約5〜10回のフルスクリーニングを無料で利用できます。

エンドポイントとトランスポート

SSE: https://mcp.halalterminal.com/sse
Auth: X-API-Key: <your_key>   (or ?api_key=<your_key>)

対応するトランスポート：SSE（推奨）、stdio（必要なクライアント向けの@halalterminal/mcpブリッジ経由）。

プランと利用枠

Halal Terminal API はリクエスト単位ではなく、トークン従量制です。

プラン	月間トークン数	価格	備考
Free	50	$0	完全なスクリーニング約5～10回分 · メールで登録、クレジットカード不要
Starter	2,500	$19	個人投資家向け
Pro	15,000	$49	Webhook、一括処理の優先対応
Enterprise	無制限	$199+	カスタムの方法論、SLA

登録：api.halalterminal.com · 料金：halalterminal.com/pricing

この MCP サーバーが提供しないもの

• ファトワーではありません。 すべての判定は、方法論に基づくスクリーニングです。個人的な判断については、資格を持つ学者に相談してください。
• 取引プラットフォームではありません。 ブローカーとの連携や注文執行には対応していません。
• リアルタイム通知システムではありません。 v1 はリクエストとレスポンスのみです。Webhook による通知は Pro 以上のロードマップに含まれています。
• v1 は英語のみです。 アラビア語とフランス語への対応はロードマップに含まれています。

よくある質問

この MCP サーバーは無料で使えますか？

はい。@halalterminal/mcp パッケージは Apache-2.0 ライセンスで、無料です。Halal Terminal API には無料枠（月500トークン、クレジットカード不要）があり、完全な株式スクリーニング約100回分を利用できます。アップグレード前の評価に十分な量です。

どの AI クライアントで使えますか？

SSE または stdio 経由で Model Context Protocol をサポートするクライアントであれば、どれでも使えます。Claude Desktop、Claude Code、Cursor、Windsurf、Cline、Continue、Zed、Goose などに対応しています。SSE を推奨します。@halalterminal/mcp パッケージは、まだ SSE をサポートしていないクライアント向けに SSE を stdio としてラップします。

「ハラール」はどのように判定されますか？

各判定では、選択した方法論で公表されているルール（AAOIFI、Dow Jones Islamic Market (DJIM)、FTSE Shariah、MSCI Islamic、S&P Shariah）が適用されます。判定は2段階です。（1）事業活動のスクリーニング（アルコール、ギャンブル、従来型金融、アダルトコンテンツ、武器、豚肉などを除外）、続いて（2）財務比率のしきい値による判定（時価総額に対する有利子負債、非流動資産、利息収入の割合など）。MCP は5つすべての判定結果を公開するため、ユーザーや学者は自分が従う基準を選べます。

配当の浄化とは何ですか？

不適合な収益が少し含まれる株式を保有している場合、学者は受け取った配当のうち不適合な割合に相当する金額を寄付するよう求めます。calculate_zakat(calculation_type="purification", …) と get_dividends(include_purification=True) は、その金額を自動計算します。

ETF のスクリーニングはできますか？

はい。screen_etf はすべての構成銘柄を確認して、それぞれに方法論を適用し、全体の判定結果、適合銘柄の割合、浄化率の合計を返します。スクーク ETF は別途処理されます（資産ベースの方法論）。

指数全体を一度にスクリーニングできますか？

はい。bulk_screen は S&P 500、NASDAQ-100、FTSE 100 などの指数を対象に非同期処理を開始します。ステータスの確認、方法論・セクター・適合銘柄のみでの結果の絞り込み、2回の処理結果の差分確認ができます。

コンプライアンスの変更をWebhookで受け取れますか？

Webhook は API の Pro プラン向け機能としてロードマップに含まれています。この MCP の v1 はリクエストとレスポンスのみです。

バグの報告やツールのリクエストはどこからできますか？

github.com/goww7/halalterminal-mcp/issues または [email protected] までメールでご連絡ください。

詳細情報

• API リファレンス
• イスラム金融の MCP サーバーを構築する
• イスラム金融とは？
• スクークのスクリーニングガイド
• 保有株はハラール？スクリーナー

Halal Terminal エコシステムの一部

ウェブサイト · API · Python SDK · JS SDK · Claude プラグイン · Discord ボット · TradingView インジケーター · ポートフォリオトラッカー

関連プロジェクト（姉妹 OSS）

同じ Halal Terminal API を共有するオープンソースツールです。インターフェースは異なりますが、データは共通です。

プロジェクト	概要	ライセンス
halalterminal-claude-skills	Claude Code プラグイン。この MCP サーバーを基盤に、厳選されたスキル、スラッシュコマンド、ポートフォリオ構築サブエージェントを提供します。	Apache-2.0
yassir-oss	ハラール金融調査向けのオープンソース ReAct エージェント。CLI とウェブ UI を備え、OpenAI／Anthropic／ローカル LLM に対応しています。	Apache-2.0
halal-discord-bot	Discord ボット。/halal AAPL、/portfolio、/trending のスラッシュコマンドを利用できます。	MIT
halal-portfolio-tracker	Next.js 14 アプリ。保有銘柄を入力すると、銘柄ごとのコンプライアンス、ポートフォリオのハラール比率、支払いが必要な浄化額を確認できます。ワンクリックで Vercel にデプロイできます。	MIT
halal-pine	チャート上にコンプライアンス状況を重ねて表示する TradingView Pine Script v5 インジケーターです。この API から毎日データを更新します。	MIT

ライセンスと商標

Apache-2.0 — LICENSE をご覧ください。

「Halal Terminal」、「HalalTerminal」、および Halal Terminal のロゴは登録商標です。TRADEMARKS.md をご覧ください。

法的情報

• 法的情報と免責事項 — 教育・研究目的であること、投資に関する免責事項、シャリーア準拠に関する通知、責任の制限、管轄区域に関する通知
• プライバシーポリシー
• Cookie ポリシー

サポート

• お問い合わせ：[email protected]
• ダッシュボード：api.halalterminal.com/dashboard
• API ドキュメント：api.halalterminal.com/docs（Swagger） · api.halalterminal.com/redoc（ReDoc）

---

Halal Terminal を利用 — halalterminal.com

---

Halal Terminal オープンエコシステムの一部： API · MCP サーバー · Python SDK · JS SDK · データセット · イスラム金融の注目プロジェクト