fAlpha

AI エージェント向け fAlpha

fAlpha の MCP サーバーは、AI アシスタントやエージェントフレームワーク向けに、読み取り専用のリサーチツールを提供します。

• 米国株の fAlpha モデルシグナルと、その背景にある要因
• シグナルの履歴、反転、期間構造
• ニュースのセンチメントとアナリストのカバレッジ
• SEC 提出書類と XBRL ファクト
• FRED のマクロ経済の背景
• 企業のファンダメンタルズ

すべての結果には、データの取得元と対象日が記載されています。

シグナルはモデルの出力であり、投資助言ではありません。このサーバーが注文を実行することはありません。

接続

• エンドポイント： https://agent.falpha.ai/mcp（Streamable HTTP）
• 認証： OAuth 2.1（PKCE 使用）、またはパーソナルアクセストークン（falpha_pat_…）
• ドキュメント： https://falpha.ai/mcp

fAlpha アカウントを使用する場合（OAuth）。 Cursor と VS Code 用のワンクリックリンクは、 https://falpha.ai/mcp#connect-account にあります。それ以外の場合：

• Claude（ウェブ版およびデスクトップ版）：
  1. Customize → Connectors → + を選択します。
  2. 名前に fAlpha を入力し、エンドポイントを貼り付けて、Add を選択します。
  3. falpha.ai でアクセスを承認します。
• ChatGPT：
  1. Settings → Security and login → Developer mode をオンにします。
  2. ChatGPT Plugins で + を選択し、エンドポイントを入力します。
  3. falpha.ai でアクセスを承認します。
• Claude Code： claude mcp add --transport http falpha https://agent.falpha.ai/mcp を実行し、その後 /mcp でサインインします。
• Codex： サーバーを ~/.codex/config.toml に追加し、その後 codex mcp login falpha を実行します：

  [mcp_servers.falpha]
  url = "https://agent.falpha.ai/mcp"
  

トークンを使用する場合。 https://falpha.ai/account#apikey で発行するか、クレジットカード不要のトライアルトークンを https://falpha.ai/mcp/trial で取得します。Authorization: Bearer falpha_pat_… として送信します。各クライアントの 設定スニペットは https://falpha.ai/mcp#connect-token にあります。

ツール

fAlpha バージョン 2026.09.23 に記載されている、読み取り専用ツール 17 個。

• falpha_signal_desk_card
  • タイトル：シグナルカード
  • 説明：1つのティッカーに対するモデルの現在の評価です。株式指標（EI、符号付き：正の値はロング寄り、負の値はショート寄り）、シグナルのリスク調整後の実績、評価を支える要因、およびシグナルの対象日を確認できます。
• falpha_signal_desk_compare
  • タイトル：2つのシグナルを比較
  • 説明：2つのティッカーの現在のシグナルを並べて比較し、どちらの評価がより強いかを確認できます。
• falpha_signal_desk_history
  • タイトル：過去の日付のシグナル
  • 説明：過去の日付時点でのシグナルとその要因を確認できます。当時の情報だけを使用する、時点ベースの読み取りです。
• falpha_signal_desk_performance
  • タイトル：期間内のシグナルのパフォーマンス
  • 説明：期間内のティッカーのパフォーマンスと、シグナルに従った場合のパフォーマンスをベンチマークと比較して確認できます。
• falpha_signal_desk_flips
  • タイトル：シグナルの方向転換
  • 説明：ルックバック期間中にシグナルの方向が変わった日付（ロングからショート、またはその逆）、各転換時の要因、現在の方向を確認できます。
• falpha_signal_desk_curve
  • タイトル：シグナルの期間構造
  • 説明：ティッカーに対するモデルの期間構造です。1日先から6か月先までの株式指標の方向、カーブの形状（強化、弱化、または反転）、および期間ごとの符号の変化の有無を確認できます。
• falpha_screener_desk
  • タイトル：カバー対象銘柄のスクリーニング
  • 説明：fAlphaがカバーする銘柄群（米国株約5,000銘柄）を、現在のシグナル（株式指標またはシグナルの実現シャープレシオ）でランキングします。方向、セクター、またはシャープレシオの最低値で絞り込めます。
• falpha_screener_desk_coverage
  • タイトル：カバー対象の確認
  • 説明：ティッカーがfAlphaのカバー対象銘柄群に含まれているかどうかを、そのセクターと最新のシグナル日付とともに確認できます。または、銘柄群をページごとに表示できます。
• falpha_sentiment_desk
  • タイトル：ニュースセンチメント
  • 説明：ティッカーの日次ニュースセンチメントスコア、スコアの算出元となった記事、および評価日を確認できます。
• falpha_sentiment_desk_trend
  • タイトル：ニュースセンチメントの推移
  • 説明：期間内のニュースセンチメントの推移を確認できます。現在の評価、期間開始時からの変化、方向、高値・安値の範囲、および日次の時系列を表示します。
• falpha_analyst_desk
  • タイトル：アナリストカバレッジ
  • 説明：ティッカーに対するセルサイドのカバレッジです。最近の目標株価に関する見解とソースへのリンク、精度で加重したコンセンサスの傾向、各アナリストの過去の的中率に加え、fAlphaのモデルに同意した場合と反対した場合それぞれの精度を確認できます。
• falpha_research_librarian
  • タイトル：fAlpha用語の定義
  • 説明：各デスクが返す用語のfAlphaによる定義を確認できます。EI（株式指標）、VICE、要因、シャープレシオ、ソルティノレシオ、percent_positive_pnl、シグナル反転、期間構造が含まれます。
• falpha_filings_scout
  • タイトル：SEC提出書類
  • 説明：SEC EDGARからティッカーの最近のSEC提出書類を取得します。デフォルトでは10-K、10-Q、8-Kが対象で、新しい順に表示され、それぞれの提出日と文書のURLを確認できます。
• falpha_filings_scout_facts
  • タイトル：SEC XBRL企業ファクト
  • 説明：SEC XBRL提出書類に記載された売上高、純利益、希薄化後EPS、総資産、総負債、株主資本などの報告済み財務データを、直近の報告四半期および会計年度について確認できます。それぞれの期間末日と提出日も表示されます。
• falpha_macro_desk
  • タイトル：マクロ環境（FRED）
  • 説明：FREDの米国マクロ環境を確認できます。FF金利（DFF）、CPI（CPIAUCSL）、失業率（UNRATE）、10年債と2年債の利回り差（T10Y2Y）、10年債利回り（DGS10）が含まれます。
• falpha_fundamentals_desk
  • タイトル：企業プロフィールと財務比率（FMP）
  • 説明：FMPの企業プロフィールと直近12か月の財務比率を確認できます。セクター、時価総額、P/E、利益率、負債資本比率が含まれます。
• falpha_open_in_web
  • タイトル：ウェブでfAlphaを開く
  • 説明：fAlphaのウェブサイトとユーザーのアカウントページへのリンクを表示します。アカウントページではプラン、利用状況、請求情報を確認できます。 このリストは、ライブサーバーの公開カタログ （https://agent.falpha.ai/mcp/catalog）から scripts/sync_tools.py によって生成されています。

Claude プラグイン

plugin/ には、fAlpha コネクターを使用する 4 つのスキルが含まれています。ティッカーの調査、銘柄の比較、セクターのスクリーニング、値動きの理由の解説です。claude --plugin-dir ./plugin を実行してローカルでお試しください。

ChatGPT プラグイン

codex-plugin/ には、ChatGPT プラグインのマニフェスト（.codex-plugin/plugin.json）、MCP 設定（.mcp.json）、アイコンが含まれています。Claude プラグインと同じ 4 つのスキルを提供します。scripts/build-codex-plugin.sh を実行すると、アップロード用の ZIP が dist/ に生成されます。

レシピ

• recipes/alpaca-paper：fAlpha から情報を読み取り、独自に判断し、Alpaca の MCP サーバーを通じて Alpaca でペーパー取引の注文を出し、改ざんを検知できる意思決定ログを保持するエージェントです。

Composio で fAlpha を使用する

Composio は、LangChain、CrewAI、OpenAI Agents SDK などで構築されたエージェントにツールカタログを提供します。Composio のカスタム MCP 機能（試験的）を使うと、独自の Composio プロジェクトに fAlpha を追加できます。

COMPOSIO_API_KEY=... scripts/composio-register.sh          # users approve read access on falpha.ai
COMPOSIO_API_KEY=... scripts/composio-register.sh api_key  # or: users paste a falpha_pat_ token

次に、エージェント内で以下を実行します。

session = composio.sessions.create(user_id="...", toolkits=["CUSTOM_FALPHA"])
tools = session.tools()

• 認証情報の保存先： Composio は各ユーザーの fAlpha 認証情報を自社側に保存します。
• エージェントが利用できるもの： 他のすべてのクライアントと同じ、読み取り専用の 17 個のツールです。

プロンプトの例

examples/prompts.md をご覧ください。

データ

• fAlpha 独自のデータ： モデルのシグナルとその要因、および公開ニュース記事から算出したニュースセンチメントです。
• Financial Modeling Prep： モデルが読み取る価格、アナリストデスクの基となるセルサイドの目標株価、企業プロフィールと各種比率です。
• SEC EDGAR： 提出書類と XBRL ファクトです。
• FRED： マクロ経済系列です。

レジストリ

fAlpha は、公式 MCP Registry に ai.falpha/mcp として登録されています（server.json がそのエントリーのソースです）。また、Smithery にも掲載されています。

ライセンス

このリポジトリに含まれるすべてのもの（レシピ、Claude プラグイン、スクリプト、サンプル）は MIT ライセンスの下で提供されています。LICENSE をご覧ください。fAlpha サービス自体（MCP サーバーおよび API）の利用には fAlpha アカウントが必要であり、fAlpha の利用規約が適用されます。MIT ライセンスの対象はこのコードであり、fAlpha のデータやサービスではありません。