fAlpha

面向 AI Agent 的 fAlpha

fAlpha 的 MCP 服务为 AI 助手和 Agent 框架提供只读研究工具：

• 某只美国股票的 fAlpha 模型信号及其背后的驱动因素；
• 信号的历史记录、反转情况和期限结构；
• 新闻情绪和分析师覆盖情况；
• SEC 文件和 XBRL 数据；
• FRED 宏观背景；
• 公司基本面。

每项结果都会注明数据来源及对应的数据日期。

信号是模型输出，不构成投资建议。服务绝不会下单。

连接

• 端点： https://agent.falpha.ai/mcp（Streamable HTTP）
• 身份验证： OAuth 2.1 with 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
  • Title: 信号卡片
  • Description: 模型对某只股票的当前判断：股票指标（EI，带正负号：正值偏向做多，负值偏向做空）、信号经风险调整后的历史表现、支撑该判断的驱动因素，以及信号对应的日期。
• falpha_signal_desk_compare
  • Title: 对比两个信号
  • Description: 并排比较两只股票的当前信号，并指出哪只股票的判断更强。
• falpha_signal_desk_history
  • Title: 某个过去日期的信号
  • Description: 查看某个过去日期的信号及其驱动因素，按时点读取：仅使用该日期可获取的数据。
• falpha_signal_desk_performance
  • Title: 一段时间内的信号表现
  • Description: 某只股票在指定日期范围内的表现，以及跟随信号时的表现，并与基准进行比较。
• falpha_signal_desk_flips
  • Title: 信号方向反转
  • Description: 回溯窗口内信号改变方向（从做多转为做空，或反之）的日期、每次变化时的驱动因素，以及当前方向。
• falpha_signal_desk_curve
  • Title: 信号期限结构
  • Description: 模型对某只股票的期限结构：从 1 天到 6 个月的股票指标方向、曲线形态（增强、减弱或反转），以及不同期限上的符号是否发生变化。
• falpha_screener_desk
  • Title: 筛选覆盖范围内的股票
  • Description: 根据当前信号（股票指标或信号实现的 Sharpe 比率）对 fAlpha 覆盖的股票范围（约 5,000 只美国股票）进行排名，并可按方向、行业或最低 Sharpe 比率筛选。
• falpha_screener_desk_coverage
  • Title: 覆盖范围检查
  • Description: 检查某只股票是否属于 fAlpha 的覆盖范围，并显示其行业和最新信号日期；也可分页浏览覆盖范围内的股票。
• falpha_sentiment_desk
  • Title: 新闻情绪
  • Description: fAlpha 对某只股票的每日新闻情绪评分、用于计算评分的文章，以及评分日期。
• falpha_sentiment_desk_trend
  • Title: 新闻情绪趋势
  • Description: 查看一段时间内新闻情绪的变化：当前读数、相较于窗口起始时的变化、方向、高低区间和每日序列。
• falpha_analyst_desk
  • Title: 分析师覆盖情况
  • Description: 某只股票的卖方覆盖情况：近期带来源链接的目标价评级、按准确率加权的共识倾向，以及每位分析师的历史命中率，包括其与 fAlpha 模型观点一致和不一致时的准确率。
• falpha_research_librarian
  • Title: 定义 fAlpha 术语
  • Description: 解释各工作台返回的 fAlpha 术语：EI（股票指标）、VICE、驱动因素、Sharpe、Sortino、percent_positive_pnl、信号反转、期限结构。
• falpha_filings_scout
  • Title: SEC 文件
  • Description: 从 SEC EDGAR 获取某只股票的近期 SEC 文件（默认包括 10-K、10-Q 和 8-K），按最新优先排序；每份文件均包含提交日期和文档 URL。
• falpha_filings_scout_facts
  • Title: SEC XBRL 公司事实
  • Description: 从 SEC XBRL 文件中获取已报告的基本面数据：营业收入、净利润、摊薄每股收益、总资产、总负债和股东权益；涵盖最新报告的季度和财年，并附上各自的期末日期和提交日期。
• falpha_macro_desk
  • Title: 宏观背景（FRED）
  • Description: 来自 FRED 的美国宏观背景：联邦基金利率（DFF）、CPI（CPIAUCSL）、失业率（UNRATE）、10 年期与 2 年期利差（T10Y2Y）和 10 年期收益率（DGS10）。
• falpha_fundamentals_desk
  • Title: 公司简介和比率（FMP）
  • Description: 来自 FMP 的公司简介和过去 12 个月比率：行业、市值、市盈率、利润率、债务权益比。
• falpha_open_in_web
  • Title: 在网页上打开 fAlpha
  • Description: 提供 fAlpha 网站和用户账户页面的链接，可在账户页面查看套餐、用量和账单。 列表由 scripts/sync_tools.py 从在线服务的公开目录 （https://agent.falpha.ai/mcp/catalog）生成。

Claude 插件

plugin/ 包含四项使用 fAlpha 连接器的技能：研究股票代码、比较公司、筛选行业，以及解读市场走势。可通过 claude --plugin-dir ./plugin 在本地试用。

ChatGPT 插件

codex-plugin/ 包含 ChatGPT 插件清单（.codex-plugin/plugin.json）、MCP 配置（.mcp.json）和图标。它提供的四项技能与 Claude 插件相同。scripts/build-codex-plugin.sh 会将上传 ZIP 写入 dist/。

Recipes

• recipes/alpaca-paper：一个 Agent，它读取 fAlpha 数据、自行做出决策、通过 Alpaca 的 MCP 服务在 Alpaca 上下达模拟交易订单，并保留防篡改的决策日志。

在 Composio 中使用 fAlpha

Composio 为使用 LangChain、CrewAI、OpenAI Agents SDK 等构建的 Agent 提供工具目录。Composio 的自定义 MCP 功能（实验性）可将 fAlpha 添加到你自己的 Composio 项目中：

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

然后，在你的 Agent 中：

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

• 凭证的存储位置： Composio 会在其平台存储每位用户的 fAlpha 凭证。
• Agent 可获取的内容： 与其他客户端相同的 17 项只读工具。

示例提示词

请参阅 examples/prompts.md。

数据

• fAlpha 自有数据： 模型信号及其驱动因素，以及根据公开新闻文章计算的新闻情绪。
• Financial Modeling Prep： 模型读取的价格、分析师工作台背后的卖方价格目标，以及公司简介和比率。
• SEC EDGAR： 文件和 XBRL 事实。
• FRED： 宏观经济序列。

注册目录

fAlpha 已列入官方 MCP Registry，名称为 ai.falpha/mcp（server.json 是该条目的源文件），也列在 Smithery 上。

许可证

本仓库中的所有内容（recipes、Claude 插件、脚本和示例）均采用 MIT 许可证；请参阅 LICENSE。使用 fAlpha 服务本身（MCP 服务和 API）需要 fAlpha 账户，并受 fAlpha 服务条款约束。MIT 许可证仅适用于此代码，不适用于 fAlpha 的数据或服务。