StoQuant — Quantitative Stock Research

stoquant-mcp

StoQuant 向けの Model Context Protocol（MCP）サーバーです。Claude（およびMCP互換のエージェント）から、StoQuantのクオンツシグナル、ML予測、スクリーニング、保有状況、マクロデータに読み取り専用で直接アクセスできます。

無料で始められます。 無料のStoQuant APIキーでは、コアツール（株価、Q-Score、スクリーナー、市場レジーム）を1日100リクエストまで利用できます。Powerでは上限がなくなり、プレミアムツール（ML、オルタナティブデータ、インサイダークラスタリング）が利用可能になります。キーは https://stoquant.com/account/api-keys から取得できます。

ソースと掲載先： GitHub · npm · 公式MCP Registry（io.github.ohadf2015/stoquant-mcp） · ランディングページ

ワンコマンドでインストール

npx -y stoquant-mcp install

APIキーの入力を求められます。インストーラーはお使いのOSに適した claude_desktop_config.json を書き込み、既存の設定をバックアップしてから、次の手順を表示します。

インストール後、Claude Desktopを完全に終了して再起動してください。list available tools と入力し、stoquant_* ツールが読み込まれていることを確認します。

手動インストール（代替方法）

claude_desktop_config.json に次の内容を追加します。

{
  "mcpServers": {
    "stoquant": {
      "command": "npx",
      "args": ["-y", "stoquant-mcp", "serve"],
      "env": {
        "STOQUANT_API_KEY": "sk_live_…"
      }
    }
  }
}

設定ファイルの場所：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

ツール（61）

カテゴリー	ツール
価格	get_quote、get_quotes_batch、get_extended_quote、get_sparklines、get_benchmarks、get_sector_performers
リサーチ	get_qscore、get_signals_v2、get_ml_prediction、explain_ml_prediction、get_strategic_edges、get_quant_analytics、get_evidence
シグナル	get_market_regime、get_signal_accuracy、get_accuracy_summary
銘柄発掘	get_top_conviction、get_hidden_gems、get_multibagger_candidates、get_related_stocks、get_signal_accuracy_heatmap
スクリーナー	list_prebuilt_screens、run_prebuilt_screen、run_screener
保有状況	get_insider_trades、get_insider_cluster、get_big_insider_buys、get_institutional_holders、get_institutional_ratings、get_analyst_estimates、get_analyst_price_targets、get_analyst_changes、get_short_interest
提出書類とニュース	get_sec_filings、get_news、get_news_events
ソーシャル	get_social_sentiment、get_social_trend、get_trending_social、get_social_momentum、get_source_credibility
カタリスト	get_catalysts、get_catalyst_watch
オルタナティブデータ	get_alt_signals（FDA、CPSC、SEC関連、臨床試験、GitHub、App Store、Hacker News、ニュースのトーンを1回の呼び出しで取得）、get_alt_data（Google Trends、Wikipediaの閲覧数、オプションIV）
オプションフロー	get_unusual_options
ポートフォリオ	get_auto_portfolio_status、get_auto_portfolio_history、get_portfolio_health、optimize_portfolio
バックテスト	list_backtest_templates、run_backtest、get_backtest、get_backtest_history
戦略	get_strategy_performance、list_strategy_presets、get_strategy_preset_candidates
マクロ	get_macro_indicator、get_macro_dashboard、get_macro_calendar、get_macro_themes

ほとんどのツールは読み取り専用のデータ取得です。run_backtest はシミュレーションの実行結果を保存します（ライブ注文やペーパー注文は行いません）。注文の発注、現金の移動、保有資産の変更は行いません。各ツールには readOnlyHint が注釈されているため、エージェントは安全に呼び出せることを判断できます。

正確性と「優位性なし」ゲート

get_accuracy_summary は、公開されている /public/accuracy/summary のスコアカードを取得します。excessSpreadPp（アルファ・スプレッド）と dataSufficient を確認してください。hitRate をスキルと見なしてはいけません。dataSufficient && excessSpreadPp < 0 の場合、自動ポートフォリオによる買いは抑止されます（gated:no_edge）。買いを前提とするポートフォリオを参照する前に、必ずこれを呼び出してください。

ポートフォリオ／バックテスト／戦略ツールは、評価、読み取り、バックテスト、最適化を行います。このサーバーが注文を発注することはありません。POST /auto-portfolio/evaluate はペーパートレードを実行しますが、公開されていません。

知っておくべき2つのこと

• Q-Score（get_qscore）は、セクター調整後のリターン（セクターのベータを除去）に基づいて算出される、主要な0〜100の総合スコアです。「この銘柄は良い銘柄か」を知るには、まずこれを確認してください。
• ML予測（get_ml_prediction）は、ある期間における S&P 500をアウトパフォームする確率（classification: bull|bear）を返します。買い／保有／売りの評価ではありません。

リソース

サーバーは、エージェントが必要に応じて参照できるドキュメントを公開しています。

• stoquant://glossary — Q-Score、MLのアウトパフォーム、レジーム、シグナルの正確性の意味と、単位の表記規則。
• stoquant://methodology — セクター調整、ICによる重み付け、MLの健全性ゲート、スクリーナーのフィールドの意味。

プロンプト

ツールを連携させた、あらかじめ用意されたワークフローです。

• analyze_ticker(ticker) — 単一銘柄の詳細分析（Q-Score + ML + 保有状況 + 優位性 → 結論）。
• find_opportunities(style) — 特定のスタイル（バリュー、モメンタム、グロース、隠れた有望株）に沿って候補リストを作成し、精査します。
• market_briefing — トップダウンの概況（レジーム + マクロ + ベンチマーク + 確信度）。

スクリーナーの使用

run_screener では、正確な camelCase のフィールド名で絞り込みます。不明なフィールドはサーバー側で null として扱われ、すべての銘柄が黙って除外されるため、ドキュメントに記載された名前を使用してください。

trailingPE、priceToBook、pegRatio、marketCap、debtToEquity、currentRatio、grossMargins、operatingMargins、revenueGrowth、earningsGrowth、rsi14、fiftyDayAverageChangePercent、twoHundredDayAverageChangePercent、fiftyTwoWeekHighChangePercent、shortPercentOfFloat、numberOfAnalystOpinions、sector、regularMarketPrice、regularMarketVolume、regularMarketChangePercent。

利益率／成長率は小数です（0.25 = 25%）。marketCap は米ドルの生の値です（250000000 = 2億5,000万）。演算子：gt、gte、lt、lte、eq、between（value: [low, high]）、in（value: [string, …]）。

スクリーナーは、StoQuant のキャッシュ済み日次ファンダメンタルデータを使用します（高速で、毎日更新）。事前調整済みの run_prebuilt_screen を優先するか、universe: "sp500" といくつかのフィルターを指定して run_screener を使用してください。

プロンプトの例

• 「NVDAのQ-Scoreを取得し、ML判定に影響している主な特徴量を説明してください。」
• 「確信度の高い上位10銘柄と、現在のMLによるアウトパフォーム確率を表示してください。」
• 「現在の市場レジームと、好調なセクターを教えてください。」
• 「sp500ユニバースに対して、割安な有望株の事前設定スクリーニングを実行してください。」
• 「sp500を対象に、trailingPEが15未満、かつdebtToEquityが0.5未満の銘柄をスクリーニングしてください。」
• 「直近の四半期におけるPLTRのインサイダー取引状況を取得してください。」
• 「現在の正確性評価とexcessSpreadPpを教えてください。テールが反転している場合は買わないでください。」
• 「自動ポートフォリオの直近の評価と保有銘柄を表示してください。gated:no_edge の場合は、買いを推奨しないでください。」
• 「バックテストのテンプレートを一覧表示し、2023年のsp500でモメンタムを実行してください。」

セキュリティ

• サーバーには STOQUANT_API_KEY が必要です。未設定または形式が不正な場合、起動時に即座に失敗します。
• すべてのリクエストで HTTPS を使用します。Authorization ヘッダーのベアラートークンは記録されません。
• 外部で使用する前に、ティッカーを検証します（^[A-Za-z0-9.\-^]{1,10}$）。
• クライアント側のレート制限は毎分200リクエストです（STOQUANT_RATE_LIMIT_RPM で設定可能）。
• リクエストごとのタイムアウトは30秒です（STOQUANT_TIMEOUT_MS で設定可能）。
• サーバー側では、APIキーは保存時にハッシュ化（SHA-256）され、高速な検索のためプレフィックスでインデックス化され、検証時にはタイミングセーフな方法で比較されます。
• https://stoquant.com/account/api-keys から、いつでもキーを失効させられます。

環境変数

変数	デフォルト	説明
STOQUANT_API_KEY	—（必須）	StoQuant API キー（無料または Power ティア）
STOQUANT_BASE_URL	https://stoquant.com/api	API のベース URL
STOQUANT_RATE_LIMIT_RPM	200	クライアント側のレート制限（リクエスト/分）
STOQUANT_TIMEOUT_MS	30000	リクエストごとのタイムアウト
STOQUANT_DEV	0	1 に設定すると、http:// のベース URL を許可します（ローカル開発のみ）

ライセンス

MIT