Fathom MCP Server

官方

面向AI代理的金融智能——涵盖8个数据源的31种工具，包括体制、衍生品、稳定币流动、动量、宏观、天气模式和政治周期。

GitHub

文档

Fathom — AI 代理的金融现实感知

为你的智能而生。你的代理在行动前所需的 FYI。

在线访问：fathom.fyi

什么是 Fathom？

Fathom 是一个 MCP 服务器，在 AI 代理做出重大决策之前，赋予它们金融现实感知能力。

问题所在： 当今在加密领域运行的每个 AI 代理都是盲目的。交易机器人能看到价格，但不理解背景。DeFi 代理部署资本时不知道我们处于周期的哪个阶段。资金管理者在没有宏观意识的情况下做出决策。它们拥有数据，但缺乏理解。

解决方案： Fathom 将 8 个实时数据源合成为可解读的情报——市场状态分类、周期定位、情绪状态、DeFi 健康状况、宏观背景和链上信号——以代理可以立即采取行动的简明英语指导形式交付。

你的代理得到的不是“BTC 价格为 82,000 美元”，而是：“市场处于后期风险规避轮动阶段。恐惧与贪婪指数为 28。BTC 主导地位上升——资本正在转向安全资产。历史类比：2022 年第四季度复苏前的积累区。建议策略：防御性。”

快速开始

零配置 — 即刻运行

添加到你的 Claude Desktop 配置中 (Settings → Developer → Edit Config)：

{
  "mcpServers": {
    "fathom": {
      "command": "npx",
      "args": ["-y", "fathom-fyi"]
    }
  }
}

保存。重启 Claude Desktop。询问 Claude：“使用 Fathom 检查市场。”

就是这样。三个免费工具，实时数据，无需 API 密钥。

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "fathom": {
      "command": "npx",
      "args": ["-y", "fathom-fyi"]
    }
  }
}

任何 MCP 客户端

Fathom 使用 stdio 传输。将任何 MCP 客户端指向 npx -y fathom-fyi。

一键解锁全部功能

在 fathom.fyi 订阅，将你的密钥添加到配置中，即可完成。一个密钥解锁所有 32 个工具、所有 8 个数据源和高级数据路由。无需其他 API 密钥——Fathom 在服务器端处理所有数据源身份验证。

"env": {
  "FATHOM_API_KEY": "fathom_sk_your_key"
}

工具（32 种工具）

免费层（4 个工具）

工具	描述
`get_reality_check`	包含市场状态、情绪、风险评分的市场简报。付费层添加替代信号。
`get_market_regime`	市场状态分类（风险偏好/风险规避、狂热、投降），附带置信度评分
`get_sentiment_state`	恐惧与贪婪指数、7 天趋势、逆向信号、极端机会检测
`get_account_status`	你的层级、使用统计、锁定工具、升级路径

入门层（25 个工具 — $29/月）

所有免费工具，外加：

工具	描述
`get_narrative_pulse`	板块轮动、加速/减速叙事、动量评分
`get_asset_context`	任何资产的深度背景：周期位置、趋势、交易量健康状况、风险水平
`get_temporal_context`	比特币减半周期定位，附带历史类比
`get_defi_health`	DeFi 生态系统 TVL、健康评分、集中度风险、收入趋势
`get_macro_context`	美联储利率、DXY、收益率曲线、衰退概率、加密影响
`get_onchain_pulse`	比特币网络健康状况、内存池、费用、挖矿经济
`set_portfolio_context`	保存你的投资组合持仓，以获取个性化指导
`set_alert`	定义自定义警报条件（例如，“恐惧与贪婪指数 < 20”）
`get_alerts`	根据实时数据检查哪些警报已被触发
`get_watchlist_report`	批量分析最多 10 项资产，检测状态变化
`evaluate_strategy`	根据实时条件测试内置或自定义策略
`get_chain_context`	每条链的 DeFi 情报（以太坊、Solana、Base、Arbitrum 等）
`get_alternative_signals`	金融中心天气、政治周期、季节性、宏观日历
`get_derivatives_context`	资金费率、期权数据（看跌/看涨比率、未平仓合约、隐含波动率、最大痛点）、杠杆定位
`get_stablecoin_flows`	稳定币供应追踪、铸造/赎回、资本流动信号、脱锚警告
`get_correlation_matrix`	BTC 与标普 500 和黄金的相关性、传统金融价格、宏观风险偏好
`set_signal_preferences`	自定义哪些信号输入到你的现实检查中
`rotate_api_key`	轮换你的 API 密钥——停用旧密钥，签发新密钥
`get_asset_momentum`	短期动量（15 分钟/1 小时/4 小时/1 天/7 天）。RSI、ATR 百分位、布林带宽度、波动率状态、置信度评分、资金费率轨迹
`get_event_catalyst_timeline`	即将到来的催化剂：FOMC、CPI、就业数据、期权到期、四巫日。影响评级、预期方向、交易笔记
`get_question_context`	用相关的 Fathom 信号丰富任何是/否问题。自动检测宏观、政治、加密、衍生品主题。专为预测市场机器人构建。

专业层（30 个工具 — $99/月）

所有入门层工具，外加：

工具	描述
`get_portfolio_analysis`	个性化投资组合分析，包含市场状态对齐和再平衡
`get_crowd_intelligence`	所有连接 Fathom 的代理的聚合行为
`get_signal_history`	Fathom 的历史记录：记录的每个信号，追踪的结果
`get_historical_context`	过去任何日期的市场状况如何？
`set_custom_strategy`	使用你自己的条件规则创建自定义交易策略

无限层（32 个工具 — $299/月）

所有专业层工具，外加：

工具	描述
`set_webhook`	注册 HTTP webhook，当市场条件满足你的标准时触发
`manage_webhooks`	列出、监控和移除活跃的 webhook

文档

文档	涵盖内容
工具参考	每个工具、每个参数、每个输出字段
输出示例	关键工具的真实 JSON 输出示例
代理提示模板	10 个即用型提示，用于常见工作流程
交易机器人骨架	带有决策逻辑的 TypeScript 机器人模式
LangChain 示例	LangChain MCP 集成

真实世界工作流程

预测市场机器人 — 调用 get_asset_momentum（15 分钟 + 4 小时）获取方向，调用 get_derivatives_context 获取资金费率 + 最大痛点，调用 get_event_catalyst_timeline 在 FOMC/CPI 附近抑制投注，并调用 get_signal_history 根据过去准确性加权信号。

每日交易简报 — 在开盘时调用 get_reality_check。如果 risk_score > 70，则减少敞口。如果 suggested_posture 为“观望”，则平掉杠杆头寸。添加 get_stablecoin_flows 以确认资本方向。

投资组合再平衡 — 使用你的持仓调用 set_portfolio_context，然后调用 get_portfolio_analysis 获取与市场状态一致的建议。使用 get_correlation_matrix 检查你的 BTC 和股票敞口是否重复计算了相同的宏观风险。

自动化警报 — 使用 set_alert 设置条件，例如 fear_greed < 20。使用 get_alerts 进行轮询。在无限层，当条件满足时，使用 set_webhook 直接 POST 到你的机器人。

示例代理提示

任何交易前：

“使用 get_reality_check 评估当前市场状况。风险评分和建议策略是什么？我应该继续这笔交易吗？”

投资组合检查：

“使用 set_portfolio_context 设置我的持仓：2 BTC、50 SOL、$10k USDC。然后使用 get_portfolio_analysis——我的投资组合是否与当前市场状态一致？”

叙事研究：

“使用 get_narrative_pulse 识别哪些加密板块正在加速。动量在哪里？”

资产尽职调查：

“使用 get_asset_context 查询 SOL，然后使用 get_reality_check 了解整体环境。这是一个好的入场点吗？”

宏观意识：

“使用 get_macro_context 和 get_temporal_context。我们处于周期的哪个阶段，宏观背景如何？”

部署资本前的风险评估：

“使用 get_reality_check。今天部署资本前，我应该注意的三大风险是什么？”

定价

层级	价格	工具	速率限制
免费	$0	4 个核心工具	10 次请求/小时
入门	$29/月	24 个工具 + 动量 + 催化剂 + 警报 + 策略 + 密钥轮换	500 次请求/小时
专业	$99/月	29 个工具 + 自定义策略 + 群体智能	2,000 次请求/小时
无限	$299/月	全部 32 个 + webhook + 无限请求 + 优化缓存	无限

在 fathom.fyi 订阅

数据源

数据源	提供内容	新鲜度
CoinGecko	价格、市值、OHLC、类别、趋势	实时
Alternative.me	恐惧与贪婪指数	实时
DeFiLlama	DeFi TVL、协议数据、稳定币供应	实时
Deribit	资金费率、期权未平仓合约、看跌/看涨比率、隐含波动率、最大痛点	实时
Yahoo Finance	标普 500、黄金——传统金融相关性	每日
FRED	联邦基金利率、DXY、收益率曲线	每日
Mempool.space	比特币网络健康状况、费用、挖矿	实时
Open-Meteo	金融中心天气（阳光效应）	实时

许可证

MIT