Iran Brokers Market Data

iran-brokers-mcp：AI エージェント向けイラン証券会社の市場データMCPサーバー

iran-brokers-mcpは、AI エージェントがイランの2つの証券会社、Mofid Securities（کارگزاری مفید、emofid.com）とAgah（کارگزاری آگاه、agah.com）を通じてテヘラン証券取引所の市場データを読み取れる、非公式の読み取り専用MCPサーバーです。
22個のツールで、テヘラン証券取引所（بورس تهران）とファラ・ボース（فرابورس）の株式、ETFとファンド（صندوق سرمایه‌گذاری）、オプション（آپشن）、債券とスクーク（اوراق）、金貨（سکه）と通貨、スクリーナー、Codalの発表および教育記事を扱えます。
APIキーや証券口座は不要で、Claude、Cursor、Copilotなど、あらゆるMCPクライアントで利用できます。

AI エージェント向け · できること · クイックスタート · ツール · 制限事項 · よくある質問 · ペルシア語

ライブのMofidおよびAgah APIで2026-11-01に検証済みです。

AI エージェント向け

• 概要： Mofid と Agah 向けの非公式 MCP サーバー（model context protocol）です。銘柄検索、株式カード、OHLC ローソク足と日次履歴、市場スナップショット、Mofid の 36 種類のランキング、Agah のマーケットウォッチとスクリーナー、価格と NAV を比較できる ETF、ファンドの詳細・履歴・比較、オプションチェーンと契約、債券と短期国債、通貨・コイン・金・コモディティの価格と履歴、Codal の提出書類、バリュエーションスコア、テクニカル集計、教育記事とコースを利用できます。
• インストール： uvx iran-brokers-mcp または claude mcp add iran-brokers -- uvx iran-brokers-mcp を実行します。トランスポートは stdio です。uv が必要です（Python 3.10 以降）。
• 認証： 不要です。任意で IRAN_BROKERS_MCP_PROXY を設定できます（すべてのリクエストに使う HTTP プロキシ URL を 1 つ、またはカンマ区切りのリストで指定します）。システムのプロキシ設定は無視されます。
• アクセス： 読み取り専用の市場データです。ログイン、ポートフォリオ・現金・注文の読み取り、注文の発注・編集・キャンセル、支払いはできません。ツールの呼び出し前に確認は必要ありません。
• ツール： 22 個あり、すべて br_ が接頭辞です。一般的な呼び出し順序：br_search -> br_stock / br_history、br_market -> br_market_top または br_stocks、br_etfs -> br_stock または br_fund、br_screener、br_rates、br_announcements、br_learn -> br_learn(ref=...)。
• source 引数： 各ソースは独自のブロック（{"mofid": ..., "agah": ...}）で応答します。all を指定した場合、失敗したソースには {"error": ...} が表示され、もう一方のソースは引き続き応答します。フィールドが異なるため、ブロックが 1 つの行に統合されることはありません。
• 使用する場面： イラン市場の株式、ファンド、オプション、指数、金、ドルの価格、ランキングやスクリーニング、チャート、企業の Codal 提出書類、または証券取引所の仕組みについてユーザーが尋ねた場合に使用します。
• 使用しない場面： ユーザーが取引や自身のポートフォリオの確認を希望する場合、またはリアルタイムのティックデータが必要な場合（ここで取得できるデータはすべて定期的に取得されるスナップショットです）は使用しないでください。生の取引所データには tsetmc-mcp、財務諸表一式には codal-mcp を使用してください。
• 出力： コンパクトな JSON です。価格の単位はリアルです（トマンに換算するには 10 で割ります）。テキストはペルシャ語です。
• 機械可読データ： server.json と iran-mcp カタログ。

できること

• Claude でテヘラン証券取引所のデータを取得： 銘柄を探し、価格カード（P/E、EPS、NAV、買い手と売り手の資金フロー、注文板）、1 分足から週足までのローソク足、指数や値動きの大きい銘柄を含む市場スナップショットを確認できます
• AI エージェントでイランの ETF を比較： 価格、NAV、乖離幅を含む ETF の一覧（Mofid は 375 本、Agah は上場 ETF 331 本）を取得し、ファンドの詳細や NAV 履歴の確認、複数ファンドの比較ができます
• オプションチェーン（コールおよびプット契約）と、個別契約の詳細を確認
• Agah のスクリーナーで任意の列を使って株式、ETF、ファンドをスクリーニングするか、Mofid の 36 種類のランキング（上昇率、売買代金、注文待ち状況など）を利用
• 債券、スクーク、短期国債の利回りに加え、通貨、暗号資産、コイン（سکه）、金、コモディティの価格と履歴を取得
• Codal の発表を企業、種類、日付で検索し、通知、ニュース、調査資料の PDF も確認
• バリュエーションとテクニカルスコア： 理論価格、ファンダメンタルスコアとテクニカルスコア、銘柄または業種別の指標集計
• 教育： Mofid のブログ、Agah Pedia の記事、Agah Academy のコース
• 設計上、読み取り専用： ログイン、注文、CAPTCHA の解決はありません

プロンプト例：

• 「今日のテヘラン証券取引所の概要を取得して：指数、値動きの大きい銘柄、ドルとコインの価格。」
• 「価格と NAV を比較してイランの ETF を比較し、最も大きなプレミアムで取引されているものを示してください。」
• 「Foolad のオプションチェーンと、コール契約 1 件の詳細を表示してください。」
• 「今週、P/E が最も低く、資金フローがプラスの銘柄はどれですか？」
• 金ファンドの価格と価格対 NAV 比率を比較してください。
• 今日、証券取引所で買い注文の待ち行列が最も長い銘柄はどれですか？
• Foolad の銘柄に関する最新の Codal 通知を取得してください。

クイックスタート

uv が必要です。API キーやアカウントは不要です。

claude mcp add iran-brokers -- uvx iran-brokers-mcp

{
  "mcpServers": {
    "iran-brokers": { "command": "uvx", "args": ["iran-brokers-mcp"] }
  }
}

{
  "servers": {
    "iran-brokers": { "type": "stdio", "command": "uvx", "args": ["iran-brokers-mcp"] }
  }
}

ツール

統合ツールでは source に mofid、agah、または all（デフォルトは角括弧内）を指定します。単一ソースのツールには、使用するブローカーが記載されています。

すべてのツールは読み取り専用です。個別の mofid-mcp または agah-mcp サーバーを使用していた場合：mf_search と ag_search → br_search；mf_symbol、mf_depth、ag_stock → br_stock；mf_history、ag_stock_history → br_history；mf_market_summary、ag_market_pulse、ag_market_overview → br_market；mf_industries、ag_industries → br_industries；mf_index、ag_index_history → br_index；mf_etfs → br_etfs；mf_learn、mf_learn_categories、ag_articles、ag_article、ag_academy → br_learn；mf_fx_gold、mf_rate_history → br_rates；ag_fund、ag_fund_trend、ag_fund_compare → br_fund；ag_options、ag_option → br_options；その他は br_ プレフィックスを付けて元の名前を使用します（mf_quote → br_quotes）。

制限事項

• ポートフォリオ、注文、現金には対応していません。 これらには証券会社へのログイン（EasyTrader、AsaTrader）が必要です。このサーバーはログインも注文の発注も行わず、これらの機能は実装されていません。
• Agah Pedia と Academy が応答するのはイラン国内のネットワークからのみです（pediaapi.agah.com と academyapi.agah.com は海外からはタイムアウトします）。エラーにもその旨が表示されます。br_learn の Mofid 側は引き続き応答します。これらの前段に海外のプロキシを置かないでください。
• Mofid は Bourse View ゲートウェイの accept-info ヘッダーに依存します（サーバーの時計から導出され、401 が発生するとクライアントが再同期します）。サイト側でこのチェックが変更されると、Mofid のツールは HTTP 401 エラーで失敗しますが、Agah 側は引き続き動作します。
• データはポーリングで取得したスナップショットで、30～60 秒間キャッシュされます。遅延や未監査の場合があり、市場の取引時間は土曜日から水曜日のテヘラン時間 09:00～12:30 頃です。
• 2 つのデータソースではファンドの ID（Mofid は ISIN、Agah は 14010557380_A01 のような national code）とフィールドが異なるため、統合ツールでは両方を並べて表示します。
• 価格の単位は Rial です。Toman に換算するには 10 で割ってください。日付は各サイトの形式に従います。

よくある質問

設定

ペルシャ語：AI アシスタント向け Mofid および Agah 証券会社 MCP サーバー

claude mcp add iran-brokers -- uvx iran-brokers-mcp

開発

git clone https://github.com/sepehr071/iran-brokers-mcp && cd iran-brokers-mcp
uv sync
uv run ruff check . && uv run ruff format --check .
uv run python -m pytest -q          # offline unit tests on recorded responses
uv run python -m pytest -m live -q  # live pass against Mofid and Agah
uv build

リリース：pyproject.tomlとserver.jsonのバージョンを更新し、v*タグをプッシュします。GitHub ActionsがPyPIに公開します。IssueやPRを歓迎します。

関連サーバー

• tsetmc-mcp：テヘラン証券取引所の価格、注文板、実取引と法人取引、指数向け
• codal-mcp：Codalの開示情報と財務諸表向け
• iran-gold-mcp：イランのプラットフォームにおけるリアルタイムの18金価格向け
• iran-mcp：イラン関連サービス向けMCPサーバーの全カタログ

免責事項

非公式のプロジェクトであり、Mofid SecuritiesまたはAgahとは提携しておらず、承認も受けていません。読み取り専用で、予告なく変更される可能性のある各社ウェブサイトの公開エンドポイントを使用しています。データは参考情報であり、遅延があり、監査されていません。ここに記載されている内容は投資助言ではありません。

作者

Sepehr Radmard（سپهر رادمرد）が開発・保守しています。LinkedInでつながるか、GitHubの@sepehr071をフォローして、イランのウェブサイト向けのその他のMCPサーバーをご覧ください。すべてiran-mcpに掲載されています。このプロジェクトが時間の節約に役立った場合は、リポジトリにスターを付けていただくと、ほかの人にも見つけてもらいやすくなります。

ライセンス

MIT