Falsifylab Alpha

falsifylab-alpha-mcp

AI 支援型の市場調査向け MCP データレイヤーです。 Claude Code、Cursor、Cline、Windsurf、または MCP 対応クライアントにそのまま追加できる、ライブ金融ツール 13 種を提供します。無料枠は登録不要です。

シグナルサービスではありません。投資助言ではありません。AI エージェント向けに軽く拡充した公開市場データです。行動を起こす前にバックテストしてください。

使い方は 2 通り

オプション 1：ホスト型 MCP（インストール不要）。 エージェントをホスト型エンドポイントに接続するだけで、Python は不要です。

{
  "mcpServers": {
    "falsifylab-alpha": {
      "url": "https://mcp.falsifylab.com/"
    }
  }
}

無料枠は自動的に適用されます。有料プランでは、Whop 経由の OAuth 2.1 + PKCE フローを使用します。ストリーマブル HTTP トランスポートに対応しています。OpenAPI 3.1 の完全な仕様は https://docs.falsifylab.com/openapi.html にあります。

オプション 2：stdio（このパッケージ）。

pip install falsifylab-alpha-mcp

実行時依存関係はありません（Python 標準ライブラリのみ）。続いてエージェントに接続してください。詳しくはクライアントの設定を参照してください。

できること

ユーザーが AI エージェントに次のような質問をすると、

• 「今日はどんなインサイダーの買い集めが起きていますか？」
• 「シャープレシオが高く、ドローダウンが 10% 未満の Hyperliquid ボールトを見せて」
• 「BTC ETF の資金フローは価格動向を裏付けていますか、それとも乖離していますか？」
• 「今のマクロテープには何が出ていますか？」
• 「勝率 60% 以上の Polymarket の大口投資家を探して」

……エージェントは 13 種のツールから 1 つを呼び出し、学習データの知識から推測するのではなく、公開市場データのリアルタイム数値に基づいて回答します。

13 種のツール

ツール	返されるデータ	用途
top_yield_farms	排出報酬を除外し、IL リスクを織り込んだ DeFi 利回り	表面上の利回りではなく、実質利回りを探す
hl_vault_leaderboard	NAV／30 日／ドローダウン／スコア別の Hyperliquid ボールト	コピートレードの参考
insider_buy_clusters	SEC Form 4 の集団買い（インサイダー 3 人以上、24 時間の期間）	株式の確信度を示すシグナル
sec8k_material_today	重要項目コードで絞り込んだ 8-K 提出書類	決算、M&A、役員の異動
macro_tape	SPX／NDX／VIX／UST／DXY／GOLD／WTI／BTC／ETH のスナップショット	トレードアイデアのレジーム判定
etf_flow_today	米国の現物 BTC および ETH ETF の集計値	機関投資家のポジショニング
active_airdrop_farms	DefiLlama の利回りギャップ・エアドロップ	待つことで報酬が得られるファーム
polymarket_whale_positions	上位ウォレットとアクティブなポジション	予測市場のコピートレード
earnings_drift_radar	決算後のドリフトと IV クラッシュ候補	株式のイベント・ボラティリティスキャナー
token_unlock_radar	今後のトークンアンロックスケジュールと規模	供給超過リスクのレーダー
fed_comm_radar	FRB の講演・イベントに伴うボラティリティ期間	マクロイベントリスクスキャナー
confluence_today	複数ソースにまたがるシグナルの一致状況	同じ資産に対する 2 つ以上のシグナルを集約
onchain_smart_wallets	Solana のコピートレードボットのライブスコア	本番環境でのウォレットランキング

すべてのツールの完全な JSON スキーマは、/.well-known/mcp/server-card.json で公開されています。

クライアントの設定

Claude Code

claude mcp add falsifylab-alpha -- python -m falsifylab_alpha_mcp

Pro プランの場合：

claude mcp add falsifylab-alpha \
  --env FL_API_KEY=fl_your_key \
  -- python -m falsifylab_alpha_mcp

Cursor

~/.cursor/mcp.json またはワークスペースルートの .mcp.json に追加します。

{
  "mcpServers": {
    "falsifylab-alpha": {
      "command": "python",
      "args": ["-m", "falsifylab_alpha_mcp"],
      "env": {
        "FL_API_KEY": "fl_your_key_or_omit_for_free_tier"
      }
    }
  }
}

Cursor を再起動します。ツールは自動検出されます。

Cline

「設定」→「MCP Servers」→「Add Server」の順に選択します。上記の Cursor と同じ JSON を貼り付けます。

Windsurf

Settings → MCP。同じ JSON 設定です。Smithery から 48 時間以内に自動インデックス化されます。

Smithery

Smithery のホスト型ゲートウェイ経由で接続できます。ローカルへの Python のインストールは不要です。smithery.ai/servers/falsifylab/falsifylab-alpha-mcpをご覧ください。

インストールを確認する

エージェントに次のように尋ねます。

macro_tape を使ってください。SPX、VIX、BTC、ETH の 1 日および 5 日リターンを表示してください。

エージェントが数値を返せば、準備完了です。

エージェント用のプロンプト例

コピーして貼り付けてください。初回から動作します。

毎日のマクロ概要：

Use macro_tape. Tell me the macro regime in 3 sentences. Cite specific
numbers — last price, 1d return, 5d return. Then list 2 tickers from
sec8k_material_today that might benefit from this regime.

インサイダー取引＋8-K の集約：

Run insider_buy_clusters (min_insiders=3) and sec8k_material_today
(items=["2.02","8.01","5.02"]). Find tickers in both within 24h. For
each match, summarize what insiders bought and what the 8-K said. End
with the bear case in one sentence.

弱気シナリオを含むコンフルエンス分析：

Use confluence_today with min_signals=2. For each asset/ticker, explain
why these signals stacking is meaningful in 2 sentences. Skip noise
(DeFi LP pools with stablecoins). Highlight the most contrarian stack.

レシピをさらに 8 件、falsifylab.com/cookbookでご覧いただけます。

料金

プラン	料金	内容
無料	$0	24 時間キャッシュ、クエリあたり 10 件、登録不要、60 リクエスト／時間
Pro	$19/mo	リアルタイム（5 分）、クエリあたり 100 件、90 日間の履歴、レート制限なし
Pro Plus	$49/mo	1 分ごとの更新、メール＋Slack アラート、株式フィードは 365 日間、Webhook
Teams	$199/mo	5 シート、1 日あたり 50k リクエスト、優先サポート

ローンチプロモーションコード EARLY50：最初の 3 か月間は 50% 割引、先着 25 件まで。falsifylab.com/proでキーを取得できます。

ライブデモ

15 分ごとにこれらのツールを呼び出す公開エージェント：falsifylab.com/demo。インストールするものと同じ MCP サーバーです。実際の数値をそのまま表示し、選別はしていません。

開発の背景

作者は毎朝 6 時に SEC EDGAR と DefiLlama のデータを手作業でスクレイピングし、多数のトレーディングボットに供給していました。その経験から開発しました。生き残ったボットは、まさにこのパイプラインからデータを取得していました。どのエージェントでも同じデータを取得できるよう、MCP サーバーとしてラップしました。

ボット群の稼働・停止状況、P&L、ドローダウンの記録は、falsifylab.com/vaultsで公開しています。

透明性

• 提供するもの：公開市場データを集約し、簡易的に拡充して MCP 経由で公開します
• 提供しないもの：取引執行、証券仲介、投資助言、シグナル販売
• データソース：SEC EDGAR（Form 4、8-K）、SoSoValue（ETF フロー）、DefiLlama（イールド）、Hyperliquid 公開 API、Polymarket 公開 API、Yahoo Finance（マクロ）
• プライバシー：無料プランのキーは IP と UA のハッシュから発行され、長期保存されません。リクエスト本文は記録されません。

テレメトリー

ローカルの stdio サーバーは、ツールごとの最小限のテレメトリーを JSONL 形式で次の場所に書き込みます。

• /var/log/falsifylab/mcp_tool_calls.jsonl（FL_MCP_TOOL_CALL_LOGで変更可能）

各行に含まれるのは、次の情報のみです。

• ts、tool、args_keys（引数名のみ）、has_api_key、key_hash（sha256 のプレフィックス）、version

このテレメトリー経路では、次の情報は記録されません。

• API キーの生データ
• 引数の値／リクエスト本文
• IP アドレス
• メールアドレス、氏名、その他のユーザー識別情報

テレメトリーを完全に無効にするには、次を実行してください。

export FL_DISABLE_TELEMETRY=1

できること、できないこと

正直な一覧です。リリースごとに更新しています。

現在できること

• 13 個すべてのツールが、エージェントの呼び出し内で p95 1 秒未満でライブデータを返します。
• 無料プランは登録の手間が一切ありません。キャッシュを使う経路では API キーも不要です。
• Form 4 のインサイダークラスターは、平日に SEC EDGAR から直接 15 分ごとに更新されます。パイプラインにサードパーティの再販業者は介在しません。
• DefiLlama のイールドは報酬トークンを除外しています（表示 APY から報酬トークン分を差し引きます）。そのため、200% のファームがどれも同じ数値になるわけではありません。
• Hyperliquid のボールト NAV の更新は、ソースティッカーから 60 秒以内に当社の R2 ミラーへ反映されます。
• Pro Plus の Telegram および Slack Webhook 配信は、cron の実行時間枠内に遅延なく行われます。ローンチ月にキューの滞留はありません。

現時点で未対応の項目

• 8-Kの重要な提出書類の一覧は、SECが提出を受け付けない週末は空になります。土曜・日曜はcount: 0を返します。想定どおりです。
• マクロテープはYahoo Financeの無料エンドポイントを使用しています。米国市場の取引時間中に15～20分の遅延が発生します。Teamsティアで有料フィードに切り替える予定ですが、それより前には対応しません。
• onchain_smart_walletsは現在Solanaのみを対象としています。BaseとEthereumのコピートレードスコアはv0.3.x向けに予定されています。
• 無料ティアのキャッシュ期間は24時間です。そのため、無料キーでのconfluence_todayは今日ではなく昨日のコンフルエンスを表示します。Proプラン（月額19ドル）では最新データを取得できます。
• 複数四半期にわたる過去データのリプレイはv0.2.xでは未対応です。ロードマップ項目として追跡しています。
• TypeScriptまたはGo向けのSDKはまだありません。Python MCP サーバーのみです。それまでは、MCP互換の任意のクライアントからstdioトランスポートを使用してください。

すでに廃止した項目

• Stripe Connectによる直接サブスクリプション（運営者のKYCが障壁でした）。Whopを利用する方針です。
• Substackの有料プラン（Stripeへの依存）。
• 以前のパッケージバージョン0.2.0では、誤ったapi.falsifylab.comホストを公開していました。4日以内に0.2.1で修正しました。最初に0.2.0を入手された方にはお詫びします。

問題を見つけた場合は、FLのXアカウントにDMを送るか、issueを作成してください。本番環境を妨げるバグは、当日中に修正をリリースします。

アーキテクチャ

your AI agent
    ↓ (MCP stdio)
falsifylab_alpha_mcp (Python stdlib, no deps)
    ↓ (HTTPS)
falsifylab.com/api/* (Cloudflare Workers)
    ↓ (cached 60s-1hr)
R2 (data feeds refreshed every 15min via cron)
    ↓ (every 15min)
Backend cron scripts (Form 4, 8-K, ETF, yield, polymarket, onchain, etc.)

無料ティアでは、データの経過時間が24時間以内のキャッシュデータを取得します。Proティアでは、同じエンドポイントに認証ヘッダーを付けてアクセスし、キャッシュを迂回して最新の上流データを取得します。

リンク

• ライブデモ：falsifylab.com/demo
• インストールガイド：falsifylab.com/install
• クックブック：falsifylab.com/cookbook
• 料金：falsifylab.com/pro
• 比較（Token Terminal／Nansen／Duneとの比較）：falsifylab.com/vs
• MCP サーバーカード：/.well-known/mcp/server-card.json
• Substack：falsifylab.substack.com
• PyPI：pypi.org/project/falsifylab-alpha-mcp
• Smithery：smithery.ai/servers/falsifylab/falsifylab-alpha-mcp
• エージェントのスターターレポジトリ：github.com/opsfalsifylab/falsifylab-agent-starter

サポート

• Issue：GitHubのissue
• メール：[email protected]
• セキュリティ：件名を[security]として、[email protected]に報告してください。48時間以内に返信します。責任ある開示はCHANGELOGにクレジットを記載します。

コントリビューション

以下のPRを歓迎します。

• 新しいツールのアイデア（範囲を相談するため、まずissueを作成してください）
• ドキュメントの改善
• バグ修正

トレードシグナル生成ツールやコピートレード用ヘルパーのPRは提出しないでください。このサーバーの対象範囲外です（当社はアドバイザリーではなく、リサーチデータ基盤を提供しています）。

ライセンス

MIT。LICENSEを参照してください。

---

FalsifyLab Alpha v0.3.3 · AIコーディングエージェント向け · 無料ティアは登録不要 · falsifylab.com