Finstack Mcp

FinStack MCP

インド市場とグローバル市場向けの無料ツールを95種類提供します。Claude、Cursor、およびあらゆるMCPクライアント内で動作します。

インド株、グローバル市場、MCP ネイティブな AI ワークフロー向けのオープンソースの市場インテリジェンスです。 Should I buy Reliance? のような質問を1つするだけで、議論、センチメント、スマートマネー、リスク、同業他社との比較、ランキングを一式で取得できます。

pip install finstack-mcp

インストールせずに実行するには、次のコマンドを使います。

uvx finstack-mcp

Claudeには、次のような質問ができます。

"Give me a full stock brief on Reliance"
-> 6 AI agents debate: FII Desk + Algo Trader + Value Investor + Retail Pulse + Macro Analyst + Options Flow
-> Consensus: BUY/HOLD/SELL with reasoning

"Is someone accumulating HDFC Bank quietly?"
-> Checks OI buildup, block deals, promoter buying, volume spike simultaneously

"What's the social buzz on TCS before results?"
-> StockTwits + Reddit + Economic Times -> 67% bullish | Signal: HOLD

"Will Nifty go up tomorrow?"
-> RSI + FII flow + PCR + VIX + G-Sec + GIFT Nifty -> 63% probability up

"Should I take a NIFTY CE or PE today?"
-> Intraday F&O setup -> BUY_CE / BUY_PE / NO_TRADE with ATM strike zone, confidence, and approval-ready summary

"Give me the 8:15 AM F&O brief"
-> GIFT Nifty + VIX + NIFTY setup + BANKNIFTY setup -> ready-to-forward morning note

"Scan my portfolio for risk"
-> Sector concentration, pledged promoters, FII exposure, XIRR, diversification score

"Is this Telegram stock tip channel a scam?"
-> Accuracy %, avg return %, pump-and-dump probability scored

デモプレビュー

株式ブリーフの実行例

エージェント対決の可視化

出力例

公開用リソース

• 実証データと精度に関する注記
• GitHub公開用の紹介文とポジショニング
• リリースチェックリスト

他との違い

• 米国市場向けの仕組みにNSE銘柄を後から少し追加したものではなく、インド市場を第一に考えて構築されています
• MCP ネイティブなので、単なるダッシュボードではなく、Claude、Cursor、その他のエージェントワークフロー内で動作します
• データ、スコアリング、議論、リサーチのワークフローを統合し、ユーザーが有料ツールを5つ組み合わせる必要がありません
• 株式の議論、ウォッチリストのランキング、株式タイムライン、Telegram トラッカー、GSTから株式への関連付け、予算分析など、競合サービスにはほとんどないツールを備えています

---

置き換えられるサービス

ツール	利用料金	finstack-mcp
Bloomberg Terminal	$31,980 / yr	無料
Bloomberg ESG + Credit	$24,000 / yr	無料
Sensibull (Options Greeks)	₹15,600 / yr	無料
Morningstar (MF flows)	$17,500 / yr	無料
Zerodha real-time data	₹6,000 / yr	Angel One経由で無料
Screener.in Pro	₹4,999 / yr	無料
Trendlyne Pro	₹4,950 / yr	無料

---

インストールと接続（2分）

pip install finstack-mcp

Claude Desktop

claude_desktop_config.json に追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "finstack": {
      "command": "python",
      "args": ["-m", "finstack.server"]
    }
  }
}

Claude Desktopを再起動すれば完了です。

Cursor / Windsurf / Cline

{
  "mcpServers": {
    "finstack": {
      "command": "python",
      "args": ["-m", "finstack.server"]
    }
  }
}

IDEのMCP設定ファイルに追加して、再読み込みします。

uvx（インストール不要）

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

対応環境：Claude Desktop · Cursor · Windsurf · Cline · Continue.dev · Zed · Jan.ai · LibreChat · あらゆるMCPクライアント

---

リモートMCP公開のロードマップ

finstack-mcp をローカルのデスクトップ設定だけでなく、コネクターのエコシステムでも利用できるようにするには、開発者向けのローカルな python -m finstack.server の設定はそのままにし、一般公開向けのホスト型リモートMCPバージョンを追加してください。

リモートHTTP向けに構築するもの

• FinStackをHTTPS経由のパブリックMCPエンドポイントとして公開します。プロトコルには、できればStreamable HTTPまたはSSEを使用します。
• 外部ユーザーに公開する前にOAuthを追加します。
• ツールの説明は範囲を絞り、明確で安全なものにします。
• レート制限、モニタリング、利用者に分かりやすいサポート窓口を用意します。
• 公式に申請する前に、プライバシーポリシーと利用規約を公開します。

ChatGPT / OpenAI向けの手順

• HTTPS経由でアクセスできるリモートMCPサーバーをホストします。
• まずChatGPTでカスタムコネクターまたはカスタムアプリとしてテストします。
• OpenAIのコネクターワークフローとの幅広い互換性が必要な場合は、search や fetch など、コネクターに適した読み取りツールを追加します。
• get_stock_brief、get_stock_debate、get_social_sentiment、analyze_portfolio など、FinStack固有のツールは、その上でドメインツールとして維持します。

Claude / Anthropic の場合

• まず、サーバーがカスタムコネクタとして動作することを確認します。
• すぐに一覧に掲載されると考えず、ディレクトリの審査に備えます。
• Anthropic は、ディレクトリに掲載する前に、安全性、セキュリティ、プライバシー、互換性の観点からサードパーティの MCP サーバーを審査します。
• サーバーが技術的に有効であっても、ディレクトリへの掲載が保証されるわけではありません。

提出に向けた実践チェックリスト

• 公開 HTTPS MCP エンドポイント
• OAuth ログインフロー
• 安定したサーバー稼働時間
• 安全なツールの範囲と説明
• プライバシーポリシー
• 利用規約
• サポート用メールアドレスまたは課題トラッカー
• 明確なドキュメントとプロンプトの例
• モデルの安全ポリシーの回避を促すツールの動作がないこと

推奨する製品構成

• ローカルの stdio MCP：開発者やパワーユーザーに最適です
• ホスト型リモート MCP：コネクタや幅広い配布に最適です
• 独立したホスト型 FinStack ウェブ UI：Agent Battle のようなプレミアムなビジュアル機能に最適です

これにより、MCP を実行レイヤーとして維持し、自社のフロントエンドをプレミアムなエクスペリエンスとして提供できます。

---

10 カテゴリにわたる 95 個のツール

インド市場（ライブデータ）

• NSE/BSE のリアルタイム株価、OHLCV 履歴、市場状況
• Nifty 50、Bank Nifty、Sensex の指数
• FII/DII の機関投資家フロー（日次および過去データ）
• 大口取引およびブロック取引、サーキットブレーカーのスキャナー、52 週高値／安値のスキャナー
• 投資信託の NAV、コーポレートアクション、決算カレンダー、IPO カレンダー

AI インテリジェンス（finstack-mcp 独自）

• get_stock_brief — 6 つの AI エージェントがあらゆる銘柄について議論し、BUY/HOLD/SELL のコンセンサスを導きます
• get_stock_debate — 反論を交えた 3 ラウンドの逐次的なエージェント間議論により、創発的なコンセンサスを導きます
• get_social_sentiment — StockTwits + Reddit + ET RSS → センチメントシグナル
• detect_unusual_activity — OI の積み上がり + ブロック取引 + プロモーターの変化 + 出来高急増
• get_nifty_outlook — 次の取引日の方向性を予測する 6 シグナル確率モデル
• get_fno_trade_setup — NIFTY / BANKNIFTY オプションの判定：BUY_CE、BUY_PE、または NO_TRADE と ATM ストライクのガイダンス
• predict_earnings — 四半期決算前の上振れ／下振れ確率
• get_fii_retail_divergence — インド市場で最も確度の高いシグナル
• get_morning_fno_brief — 承認用セットアップ概要を含む、NIFTY/BANKNIFTY F&O の日次ブリーフ

リサーチとランキング

• scan_watchlist — ウォッチリストを一括でランク付けし、自動化によって有望な買い候補と主なリスクを提示します
• get_stock_signal_score — 自動化に適したスコア。各要因の影響、支持要因、リスクを含みます
• get_stock_timeline — ニュース、決算、インサイダー取引、大口取引、センチメント、担保設定、スマートマネーをまとめたフィード
• get_sector_peer_context — セクターの強さに加え、同業他社内の順位やバリュエーションの状況を提示します
• evaluate_signal_quality — 精度を主張する前に、価格アクションの中核を正直に検証するためのレイヤー

ポートフォリオとリスク

• analyze_portfolio — 損益、XIRR、セクター集中度、リスクフラグ、分散スコア
• get_mf_overlap — AMFI の公開情報に基づくファンドの重複率
• get_pledge_alert — 前四半期比の変化速度を含む、プロモーターの担保設定に関する早期警告
• scan_pledge_risks — ウォッチリスト全体の担保設定リスクを一括スキャン
• predict_circuit — 下限サーキットリスクの予測
• detect_pump — 小型株／超小型株向けのパンプ・アンド・ダンプパターン検出

ブローカー連携（遅延ゼロのライブデータ）

• Angel One SmartAPI — リアルタイム株価、Level 2 の板情報、日中足
• Fyers API v3 — リアルタイム株価と足
• ICICI Breeze — リアルタイム株価と足
• Dhan SmartAPI — リアルタイム株価と足
• Upstox API v2 — リアルタイム株価と足

オプションとグリークス

• PCR、建玉、最大ペインを含む NSE の完全なオプションチェーン
• Black-Scholes のグリークス：デルタ、ガンマ、セータ、ベガ、ロー
• 建玉分析、IV サマリー、建玉上位のストライク

市場インテリジェンス

• India VIX + シグナル、GIFT Nifty のプレマーケット情報
• NSE のインサイダー取引（SAST 提出書類）、プロモーターの株式保有率 + 担保設定率
• RBI の政策金利、インドのマクロ指標（CPI、GDP、CAD）
• AMFI の投資信託フロー、インド国債のイールドカーブ
• get_sebi_alerts — SEBI の執行命令トラッカー（暴落の早期警告）
• get_morning_brief — 午前 8:15 のプレマーケットブリーフ

これまでにない機能（インド特化）

• correlate_gst_to_stocks — GST の月次データを、セクターの 1～3 か月先行指標として活用
• get_agm_brief — AGM／EGM の異例の決議を検出（債務調達、給与引き上げ、担保設定の承認）
• get_insider_signal — SEBI SAST のインサイダー売買パターンと将来リターンの比較
• get_telegram_tracker — ダラル・ストリートの投資情報チャンネルの精度 + パンプ・アンド・ダンプのスコアリング
• analyze_budget_live — FM の演説を貼り付けると、セクター／銘柄のシグナルを即座に表示（2 月 1 日）
• get_budget_impact — 年ごとの連邦予算で過去に上昇した銘柄 + 下落した銘柄

ファンダメンタルズ

• 損益計算書、貸借対照表、キャッシュフロー（インド + 米国）
• 主要指標：P/E、ROE、利益率、負債／自己資本比率、成長率
• 企業概要、配当履歴（過去 10 年）、銘柄比較

グローバル市場 + 暗号資産 + 税金

• 米国、EU、世界の株式 — 株価 + 履歴
• 暗号資産：BTC、ETH、SOL、100 以上のコイン（CoinGecko）
• 外国為替：USD/INR、EUR/INR、50 以上の通貨ペア
• SEC 提出書類（10-K、10-Q、8-K）
• LTCG／STCG 税金計算ツール（2024 年 7 月以降の予算ルールに対応 — これを備えているのは他にありません）

---

精度と評価

FinStack は、予測を保証するマシンではなく、意思決定支援エンジンとして紹介してください。

• get_stock_signal_score は、トリアージ、スクリーニング、自動化のためのランキングレイヤーです
• evaluate_signal_quality は、価格アクションの中核を誠実に検証するレイヤーです
• 実際の稼働システムではセンチメント、インサイダー活動、担保設定リスク、マクロ要因、同業他社の状況も使用するため、バックテストの数値を「FinStack の精度」として宣伝すべきではありません
• ユーザー向けに最も安全な表現は、シグナルエンジン、リサーチアシスタント、多要因ランキング、意思決定支援です

---

インド市場ツールとの比較

機能	finstack-mcp	Screener.in	Tickertape	Sensibull	Trendlyne	TradingView
AI エージェントが銘柄について議論	✅	❌	❌	❌	❌	❌
ソーシャルセンチメント（Reddit + StockTwits）	✅	❌	❌	❌	❌	❌
Nifty の方向性確率	✅	❌	❌	❌	❌	❌
Telegram の投資情報チャンネルトラッカー	✅	❌	❌	❌	❌	❌
予算演説のリアルタイム分析	✅	❌	❌	❌	❌	❌
GST → セクター銘柄予測	✅	❌	❌	❌	❌	❌
パンプ・アンド・ダンプ検出器	✅	❌	❌	❌	❌	❌
プロモーターの担保設定に関する早期警告	✅	❌	✅ 有料	❌	✅ 有料	❌
オプションのグリークス	✅ 無料	❌	❌	✅ ₹1,300/月	❌	✅ 有料
FII／DII の資金フロー	✅ 無料	❌	✅	✅	✅ 有料	❌
ファンダメンタルズ（P/E、ROE など）	✅ 無料	✅ 無料	✅	❌	✅	✅ 有料
Claude／Cursor 内で動作	✅	❌	❌	❌	❌	❌
価格	無料	₹4,999/年	₹2,800/年	₹15,600/年	₹4,950/年	$168/年

---

リアルタイムデータ（任意）

設定なしの場合：15 分遅延のデータ（yfinance — 無料、API キー不要）。 Angel One を利用する場合：遅延なし、レベル 2 の板情報、日中足。

pip install finstack-mcp[broker]

ANGEL_API_KEY=your_key
ANGEL_CLIENT_ID=your_client_id
ANGEL_PASSWORD=your_pin
ANGEL_TOTP_SECRET=your_totp_secret

smartapi.angelbroking.com で無料アカウントを作成できます。キーは .env 内でローカルに保管され、マシンの外に出ることはありません。

その他のブローカー：Fyers、ICICI Breeze、Dhan、Upstox にも対応しています。

---

データソース

ソース	対象範囲	必要なキー
yfinance	NSE／BSE／米国株式、暗号資産、外国為替、履歴データ	不要
NSE direct API	FII／DII、オプションチェーン、インサイダー取引、コーポレートアクション	不要
BSE India API	信用格付け、ESG／BRSR	不要
SEC EDGAR	米国の提出書類（10-K、10-Q、8-K）	不要
CoinGecko	暗号資産の市場データ	不要
World Bank	インドのマクロ経済指標：CPI、GDP、CAD	不要
AMFI / mfapi.in	投資信託のNAV、AUM、SIPの資金流入	不要
StockTwits	トレーダーのセンチメント（強気／弱気のタグ付け済み）	不要
Reddit (praw)	r/IndiaInvestments + r/DalalStreetTalks	任意（無料）
Finance Ministry	月次のGST徴収データ	不要
SEBI public filings	執行命令、インサイダーによるSAST開示	不要
Angel One SmartAPI	NSEのリアルタイムデータ、レベル2の板情報、日中取引	無料アカウント

---

トラブルシューティング

インストール後、Claude に「finstack not found」と表示される

• Claude Desktop を完全に再起動してください（閉じるだけでなく、システムトレイから終了してください）
• Windows の設定ファイルのパス：%APPDATA%\Claude\claude_desktop_config.json
• Python が PATH にあることを確認してください：python --version

pip install が失敗する

python -m pip install --upgrade pip
pip install finstack-mcp

Angel One の TOTP が失敗する

• TOTP シークレットはパスワードとは異なります。Angel One アプリで「Profile」→「Enable TOTP」→シークレットキーを確認してください
• インストール：pip install finstack-mcp[broker]

---

開発

git clone https://github.com/finstacklabs/finstack-mcp.git
cd finstack-mcp
pip install -e .[dev]
pytest -q

PRを歓迎します。新しいブローカーを追加するには、src/finstack/data/broker_X.py を作成し、tools/ に登録してください。

---

リンク

• PyPI：https://pypi.org/project/finstack-mcp/
• ランディングページ：https://finstacklabs.github.io/
• YouTube：https://youtu.be/PWK89gBbHEM
• X：https://x.com/finstacklabs1

---

MIT ライセンス · finstacklabs.github.io