Falsifylab Alpha

falsifylab-alpha-mcp

面向 AI 辅助市场研究的 MCP 数据层。 13 个实时金融工具，可直接接入 Claude Code、Cursor、Cline、Windsurf 或任何兼容 MCP 的客户端。免费套餐无需注册。

不是信号服务，也不是投资建议。提供经轻度整理的公开市场数据，供 AI Agent 使用。采取行动前请先进行回测。

两种使用方式

选项 1：托管 MCP（无需安装）。 将 Agent 指向托管端点，无需 Python。

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

自动应用免费套餐。付费套餐通过 Whop 使用 OAuth 2.1 + PKCE 流程。采用 Streamable HTTP 传输。完整的 OpenAPI 3.1 规范见 https://docs.falsifylab.com/openapi.html。

选项 2：stdio（此软件包）。

pip install falsifylab-alpha-mcp

零运行时依赖（仅使用 Python 标准库）。然后将其连接到你的 Agent。请参阅客户端设置。

功能介绍

当用户向你的 AI Agent 提出如下问题时：

• “今天有哪些内部人士正在形成集群买入？”
• “列出夏普比率出色且回撤低于 10% 的 Hyperliquid 金库。”
• “BTC ETF 资金流向是在确认还是背离价格走势？”
• “当前的宏观行情如何？”
• “找出胜率达到 60% 以上的 Polymarket 巨鲸。”

……Agent 会调用 13 个工具之一，根据公开市场数据中的实时数据作答，而不是依据训练数据中的知识进行猜测。

13 个工具

工具	返回内容	用途
top_yield_farms	剔除代币排放收益并计入无常损失风险后的 DeFi 收益率	寻找真实收益，而非表面收益
hl_vault_leaderboard	按 NAV／30 天表现／回撤／评分排列的 Hyperliquid 金库	复制交易参考
insider_buy_clusters	SEC Form 4 集群买入（3 名以上内部人士，24 小时窗口）	股票信心信号
sec8k_material_today	按重要事项代码筛选的 8-K 文件	财报、并购、高管变动
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	美联储发言人／事件波动窗口	宏观事件风险扫描器
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

设置 → MCP。使用相同的 JSON 配置。Smithery 会在 48 小时内自动编入索引。

Smithery

通过 Smithery 托管网关连接——无需在本地安装 Python。参见 smithery.ai/servers/falsifylab/falsifylab-alpha-mcp。

验证安装

在你的 Agent 中询问：

使用 macro_tape。显示 SPX、VIX、BTC、ETH 的 1d 和 5d 回报率。

如果 Agent 返回了数字，就说明已连接成功。

实用 Agent 提示词

复制粘贴即可。首次运行就能使用。

每日宏观简报：

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	实时数据（5min），每次查询 100 条结果，90d 历史数据，无速率限制
Pro Plus	$49/mo	1 分钟刷新，邮件 + Slack 提醒，股票数据源保留 365d，webhook
Teams	$199/mo	5 个席位，每天 50k 次请求，优先支持

上线促销码 EARLY50：首 3 个月享 5 折，限 25 次兑换。前往 falsifylab.com/pro 获取密钥。

在线演示

每 15 分钟调用这些工具的公开 Agent：falsifylab.com/demo。就是你将安装的同一个 MCP 服务。数据真实，不做筛选。

项目缘起

作者每天早上 6 点手动抓取 SEC EDGAR 和 DefiLlama 数据，供一批交易机器人使用，因此开发了这个项目。存活下来的机器人正是使用这条数据管道。随后将其封装为 MCP 服务，让任何 Agent 都能获取相同的数据。

这批机器人的运行记录（存活 + 停止、盈亏、回撤）公开于 falsifylab.com/vaults。

透明度

• 我们做什么：汇总并轻度丰富公开市场数据，通过 MCP 提供
• 我们不做什么：交易执行、经纪服务、投资建议、出售信号
• 数据来源：SEC EDGAR（Form 4、8-K）、SoSoValue（ETF 资金流）、DefiLlama（收益率）、Hyperliquid 公共 API、Polymarket 公共 API、Yahoo Finance（宏观数据）
• 隐私：免费套餐的密钥根据 hash(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 个工具在 Agent 调用中均可返回实时数据，p95 延迟低于 1 秒。
• 免费套餐无需注册，使用缓存数据无需 API 密钥。
• 工作日每 15 分钟直接从 SEC EDGAR 刷新 Form 4 内部人士集群，数据管道中没有第三方转售商。
• 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/mo 方案可获取实时数据。
• 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 账号发私信，或提交 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
• Agent 入门仓库：github.com/opsfalsifylab/falsifylab-agent-starter

支持

• 问题反馈：GitHub issues
• 电子邮件：[email protected]
• 安全问题：发送邮件至 [email protected]，并将主题设为 [security]。我们会在 48h 内回复。负责任地披露问题者将在 CHANGELOG 中获得鸣谢。

贡献

欢迎提交 PR，内容包括：

• 新工具创意（请先提交 issue 讨论范围）
• 文档改进
• 错误修复

请勿提交交易信号生成器或跟单辅助工具相关的 PR——这不属于本服务的范围（我们提供的是研究数据基础设施，而非投资建议）。

许可证

MIT。请参阅 LICENSE。

---

FalsifyLab Alpha v0.3.3 · 为 AI 编码 Agent 打造 · 免费版无需注册 · falsifylab.com