fathom-fyi
Fathom is an MCP server that gives AI agents real-time financial reality awareness for crypto markets, synthesizing data from 8 sources into interpreted intelligence for informed decision-making.
Market Intelligence: Get a unified market briefing synthesizing regime, sentiment, risk score, DeFi, macro, on-chain, and narrative data. Classify market regimes (risk-on, risk-off, euphoric, capitulation), check Fear & Greed Index with contrarian signals, and identify accelerating/decelerating narratives and sector rotation.
Asset Analysis: Get deep context on any crypto asset including cycle position, trend, volume health, and risk level. Analyze multi-timeframe momentum (15m–7d) with RSI, ATR, and Bollinger bandwidth, or batch analyze up to 10 assets at once.
Macro & On-Chain Data: Access Fed rates, DXY, yield curve, and recession probability. Monitor Bitcoin network health, mempool, fees, and mining economics. View BTC correlation with S&P 500 and Gold, and get halving cycle positioning with historical analogs.
DeFi Intelligence: Assess DeFi ecosystem health, TVL, and concentration risk. Get per-chain intelligence for Ethereum, Solana, Base, Arbitrum, and more. Track stablecoin supply changes, minting/redemptions, and capital flow signals.
Derivatives & Events: Access funding rates, options data (put/call ratio, OI, implied volatility, max pain), and leverage positioning. Get upcoming event catalysts (FOMC, CPI, options expiry) and unconventional signals like weather in financial centers, political cycles, and seasonality.
Portfolio Management: Save portfolio holdings for personalized, regime-aligned analysis with rebalancing suggestions.
Alerts & Automation: Set custom alerts based on market condition thresholds, register HTTP webhooks that fire when conditions are met, and evaluate built-in or custom trading strategies against live data.
History & Research: Look up historical market conditions on any past date, view Fathom's signal log and track record, and enrich prediction market questions with relevant signals.
Account Management: Check account tier, usage stats, and available tools. Rotate API keys, customize which signals feed into your reality check, and view aggregate behavior of all Fathom-connected agents.
Provides real-time Bitcoin on-chain intelligence, including network health, mempool fees, mining economics, and halving cycle positioning.
Delivers chain-specific DeFi intelligence for the Ethereum ecosystem, including TVL tracking, health scores, and revenue trends.
Offers deep context for the Solana ecosystem, providing asset-specific data, chain health metrics, and DeFi intelligence.
Fathom — Financial Reality for AI Agents
For Your Intelligence. The FYI your agent needs before it acts.
Live at fathom.fyi
What is Fathom?
Fathom is an MCP server that gives AI agents financial reality awareness before they make consequential decisions.
The problem: Every AI agent operating in crypto today is blind. Trading bots see prices but don't understand context. DeFi agents deploy capital without knowing where we are in the cycle. Treasury managers make decisions without macro awareness. They have data but no understanding.
The solution: Fathom synthesizes 8 real-time data sources into interpreted intelligence — regime classification, cycle positioning, sentiment state, DeFi health, macro context, and on-chain signals — delivered as plain English guidance an agent can act on immediately.
Your agent doesn't get "BTC is $82,000." It gets: "Market is in late-stage risk-off rotation. Fear & Greed at 28. BTC dominance rising — capital rotating to safety. Historical analog: Q4 2022 pre-recovery accumulation zone. Recommended posture: defensive."
Related MCP server: Toolstem MCP Server
Quick Start
Zero config — works immediately
Add to your Claude Desktop config (Settings → Developer → Edit Config):
{
"mcpServers": {
"fathom": {
"command": "npx",
"args": ["-y", "fathom-fyi"]
}
}
}Save. Restart Claude Desktop. Ask Claude: "Use Fathom to check the market."
That's it. Three free tools, live data, no API keys needed.
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"fathom": {
"command": "npx",
"args": ["-y", "fathom-fyi"]
}
}
}Any MCP client
Fathom uses stdio transport. Point any MCP client at npx -y fathom-fyi.
Unlock everything with one key
Subscribe at fathom.fyi, add your key to the config, and you're done. One key unlocks all 32 tools, all 8 data sources, and premium data routing. No other API keys needed — Fathom handles all data source authentication server-side.
"env": {
"FATHOM_API_KEY": "fathom_sk_your_key"
}Tools (32 instruments)
Free Tier (4 tools)
Tool | Description |
| Market briefing with regime, sentiment, risk score. Paid tiers add alternative signals. |
| Regime classification (risk-on/off, euphoric, capitulation) with confidence scoring |
| Fear & Greed Index, 7-day trend, contrarian signals, extreme opportunity detection |
| Your tier, usage stats, locked tools, upgrade path |
Starter Tier (25 tools — $29/mo)
All free tools plus:
Tool | Description |
| Sector rotation, accelerating/decelerating narratives, momentum scoring |
| Deep context on any asset: cycle position, trend, volume health, risk level |
| Bitcoin halving cycle positioning with historical analogs |
| DeFi ecosystem TVL, health score, concentration risk, revenue trends |
| Fed rates, DXY, yield curve, recession probability, crypto impact |
| Bitcoin network health, mempool, fees, mining economics |
| Save your portfolio holdings for personalized guidance |
| Define custom alert conditions (e.g., "fear_greed < 20") |
| Check which of your alerts are triggered against live data |
| Batch analyze up to 10 assets with state change detection |
| Test built-in or custom strategies against live conditions |
| Per-chain DeFi intelligence (Ethereum, Solana, Base, Arbitrum, etc.) |
| Weather in financial centers, political cycles, seasonality, macro calendar |
| Funding rates, options data (put/call, OI, IV, max pain), leverage positioning |
| Stablecoin supply tracking, minting/redemptions, capital flow signal, depeg warnings |
| BTC correlation with S&P 500 and Gold, TradFi prices, macro risk appetite |
| Customize which signals feed into your reality check |
| Rotate your API key — deactivates old key, issues new one |
| Short-term momentum (15m/1h/4h/1d/7d). RSI, ATR percentile, Bollinger bandwidth, volatility state, confidence score, funding trajectory |
| Upcoming catalysts: FOMC, CPI, jobs, options expiry, quad witching. Impact rating, expected direction, trading notes |
| Enrich any yes/no question with relevant Fathom signals. Auto-detects macro, political, crypto, derivatives topics. Built for prediction market bots. |
Pro Tier (30 tools — $99/mo)
All Starter tools plus:
Tool | Description |
| Personalized portfolio analysis with regime alignment and rebalancing |
| Aggregate behavior of all Fathom-connected agents |
| Fathom's track record: every signal logged, outcomes tracked |
| What were market conditions on any past date? |
| Create custom trading strategies with your own condition rules |
Unlimited Tier (32 tools — $299/mo)
All Pro tools plus:
Tool | Description |
| Register HTTP webhooks that fire when market conditions meet your criteria |
| List, monitor, and remove active webhooks |
Documentation
Doc | What it covers |
Every tool, every parameter, every output field | |
Real JSON output examples for key tools | |
10 ready-to-use prompts for common workflows | |
TypeScript bot pattern with decision logic | |
LangChain MCP integration |
Real-World Workflows
Prediction Market Bot — Call get_asset_momentum (15m + 4h) for direction, get_derivatives_context for funding rates + max pain, get_event_catalyst_timeline to suppress bets near FOMC/CPI, and get_signal_history to weight signals by past accuracy.
Daily Trading Briefing — Call get_reality_check at market open. If risk_score > 70, reduce exposure. If suggested_posture is "sideline", close leveraged positions. Add get_stablecoin_flows to confirm capital direction.
Portfolio Rebalancing — set_portfolio_context with your holdings, then get_portfolio_analysis for regime-aligned suggestions. Use get_correlation_matrix to check if your BTC and equity exposure are double-counting the same macro risk.
Automated Alerts — set_alert for conditions like fear_greed < 20. Poll with get_alerts. On Unlimited tier, set_webhook to POST directly to your bot when conditions are met.
Example Agent Prompts
Before any trade:
"Use get_reality_check to assess current market conditions. What is the risk score and suggested posture? Should I proceed with this trade?"
Portfolio check:
"Use set_portfolio_context with my holdings: 2 BTC, 50 SOL, $10k USDC. Then use get_portfolio_analysis — is my portfolio aligned with the current regime?"
Narrative research:
"Use get_narrative_pulse to identify which crypto sectors are accelerating. Where is the momentum?"
Asset due diligence:
"Use get_asset_context for SOL, then get_reality_check for the overall environment. Is this a good entry point?"
Macro awareness:
"Use get_macro_context and get_temporal_context. Where are we in the cycle and what's the macro backdrop?"
Risk assessment before deploying capital:
"Use get_reality_check. What are the top 3 risks I should be aware of before deploying capital today?"
Pricing
Tier | Price | Tools | Rate Limit |
Free | $0 | 4 core tools | 10 req/hr |
Starter | $29/mo | 24 tools + momentum + catalysts + alerts + strategies + key rotation | 500 req/hr |
Pro | $99/mo | 29 tools + custom strategies + crowd intelligence | 2,000 req/hr |
Unlimited | $299/mo | All 32 + webhooks + unlimited requests + optimized cache | Unlimited |
Data Sources
Source | What it provides | Freshness |
CoinGecko | Prices, market caps, OHLC, categories, trending | Real-time |
Alternative.me | Fear & Greed Index | Real-time |
DeFiLlama | DeFi TVL, protocol data, stablecoin supply | Real-time |
Deribit | Funding rates, options OI, put/call, implied vol, max pain | Real-time |
Yahoo Finance | S&P 500, Gold — TradFi correlation | Daily |
FRED | Fed Funds Rate, DXY, yield curve | Daily |
Mempool.space | Bitcoin network health, fees, mining | Real-time |
Open-Meteo | Weather in financial centers (sunshine effect) | Real-time |
License
MIT
Available Tools
31 toolsevaluate_strategyA
Evaluate a trading strategy against current market conditions. Built-in strategies: conservative_dca, momentum_rider, macro_aligned, fear_accumulator, full_defensive. Also evaluates custom strategies created with set_custom_strategy.
Inputs: strategy (required).
get_account_statusA
Check your Fathom account: current tier, requests used this hour, available and locked tools, cache freshness, and upgrade options. Available on all tiers including free.
Inputs: no named parameters.
get_alertsA
Check which of your configured alerts are currently triggered. Evaluates all alert conditions against live market data.
Inputs: no named parameters.
get_alternative_signalsB
Unconventional market signals that 99% of agents ignore. Weather in financial centers (sunshine effect), political cycle positioning (presidential year), seasonality patterns (sell in May, January effect, Santa Claus rally), and macro event calendar (FOMC, CPI, options expiry). Academically documented patterns most tools overlook.
Inputs: no named parameters.
get_asset_contextA
Get deep context on a specific crypto asset: cycle position, price trend, volume health, holder behavior, risk level, and positioning guidance. Pass asset name or symbol (e.g., "bitcoin", "btc", "ethereum", "sol").
Inputs: asset (required).
get_asset_momentumA
Short-term momentum signal for any asset. Returns direction, strength, confidence_score (-100 to +100), RSI, ATR percentile, Bollinger bandwidth, volatility state (compressed/normal/expanding/extreme), volume trend, and momentum score. Timeframes: 15m, 1h, 4h, 1d, 7d. Essential for timing entries and exits.
Inputs: asset (required), timeframe.
get_chain_contextA
Get DeFi context for a specific blockchain: TVL, dominance, trend, top protocols, and whether the chain is gaining or losing market share. Supports: ethereum, solana, base, arbitrum, optimism, polygon, avalanche, bsc, tron, bitcoin.
Inputs: chain (required).
get_correlation_matrixA
BTC correlation with traditional finance: 30-day Pearson correlation with S&P 500 and Gold, plus current TradFi prices. Shows whether BTC is trading as a risk asset, safe haven, or independently. Critical for understanding macro spillover risk.
Inputs: no named parameters.
get_crowd_intelligenceA
[BETA] See what other Fathom-connected agents are doing. Returns aggregate posture distribution, consensus strength, most-queried assets, and crowd fear levels. Signal quality scales with network size.
Inputs: no named parameters.
get_defi_healthA
Assess DeFi ecosystem health: total TVL, TVL trends, top chains and protocols, health score, revenue trends, and ecosystem concentration risk.
Inputs: no named parameters.
get_derivatives_contextA
Derivatives intelligence: perpetual funding rates (BTC/ETH/SOL), options data (put/call ratio, open interest, implied volatility, max pain price), and leverage positioning. Critical for understanding market positioning and liquidation risk. Data from Deribit.
Inputs: no named parameters.
get_event_catalyst_timelineA
Upcoming market-moving events: FOMC, CPI, jobs reports, options expiry, quad witching, political events, BTC halving. Returns next 24h, 7d, and 30d catalysts with impact ratings, expected direction, historical volatility, and specific trading notes for each event.
Inputs: no named parameters.
get_historical_contextA
Look up what market conditions were on a specific date. Returns regime, fear/greed, risk score, BTC price, and TVL from that date. Useful for comparing past conditions to current ones.
Inputs: date (required).
get_macro_contextB
Get macro economic context for crypto: Federal Funds Rate, DXY (dollar strength), yield curve, recession probability, and net macro impact on crypto.
Inputs: no named parameters.
get_market_regimeA
Classify the current crypto market regime (risk-on, risk-off, transitional, euphoric, capitulation) with confidence score, evidence, historical analog, and actionable agent guidance.
Inputs: no named parameters.
get_narrative_pulseA
Identify accelerating, decelerating, and emerging crypto narratives. Shows sector rotation, momentum scores, and narrative cycle phase for positioning.
Inputs: no named parameters.
get_onchain_pulseA
Get Bitcoin on-chain health: mempool congestion, fees, miner distribution, network security, mining economics, and activity levels.
Inputs: no named parameters.
get_portfolio_analysisA
Get personalized portfolio analysis against current market conditions. Shows position values, allocation percentages, PnL, concentration risk, regime alignment, and specific rebalancing suggestions. Requires set_portfolio_context to be called first.
Inputs: no named parameters.
get_reality_checkA
The master tool. Synthesizes ALL data sources into a unified financial reality briefing: executive summary, risk/opportunity scores, regime, cycle, DeFi, macro, sentiment, on-chain, narratives, suggested posture, key risks, and key opportunities. Call this before any financially consequential decision.
Inputs: no named parameters.
get_sentiment_stateB
Get the current crypto sentiment state including Fear & Greed Index, 7-day trend, contrarian signals, and whether extreme fear/greed opportunities are active.
Inputs: no named parameters.
get_signal_historyB
[BETA] View Fathom's signal log. Shows recent signals with their regimes, postures, and risk scores. Useful for tracking how conditions evolved over time. Accuracy scoring is under development.
Inputs: limit.
get_stablecoin_flowsA
Track stablecoin supply changes across USDT, USDC, and all major stablecoins. Shows total supply, 24h/7d/30d minting and redemptions, net capital flow signal, depeg warnings, and liquidity assessment. Stablecoin flows are a leading indicator of capital entering or leaving crypto.
Inputs: no named parameters.
get_temporal_contextA
Get Bitcoin halving cycle positioning: days since last halving, estimated cycle phase, historical analogs from cycles 1-3, and cycle-based guidance.
Inputs: no named parameters.
get_watchlist_reportA
Analyze multiple assets at once. Returns cycle position, risk level, and volume health for each. Detects state changes since last check. Max 10 assets.
Inputs: assets (required).
manage_webhooksA
List all registered webhooks or remove one by ID. Use action "list" to see all webhooks with their conditions, trigger counts, and last triggered time. Use action "remove" with a webhook_id to delete a webhook.
Inputs: action (required), webhook_id.
rotate_api_keyA
Rotate your Fathom API key. Generates a new key, deactivates the old one, and returns the new key. The user must update their MCP config with the new key. Max 3 rotations per day. Requires Starter tier or above.
Inputs: no named parameters.
set_alertA
Set custom alerts that trigger when market conditions meet your thresholds. Example: [{field: "fear_greed", operator: "<", threshold: 20, label: "Extreme fear"}]. Call get_alerts to check which are triggered.
Inputs: alerts (required).
set_custom_strategyA
Create a custom trading strategy with your own conditions. Then use evaluate_strategy to test it against current market conditions.
Inputs: name (required), conditions (required).
set_portfolio_contextA
Save your portfolio holdings so Fathom can give personalized guidance. Pass an array of holdings with asset name and amount. Example: [{asset: "bitcoin", amount: 2}, {asset: "solana", amount: 50}, {asset: "usdc", amount: 10000}].
Inputs: holdings (required).
set_signal_preferencesA
Customize which signals feed into your reality check. Turn individual signal sources on or off. Regime and sentiment are always included. Preferences persist between sessions. Example: {weather: false, political_cycle: false} to disable those signals.
Inputs: cycle, defi, macro, onchain, +5 more.
set_webhookA
Register a webhook that fires when market conditions meet your criteria. Fathom evaluates conditions every 60 seconds and POSTs a JSON payload to your URL when all conditions are met. Example: alert me at my bot URL when fear_greed < 20 and regime == capitulation. Available fields: fear_greed, risk_score, opportunity_score, regime, posture, cycle_phase, tvl_change_7d, defi_health, macro_impact, net_flow_signal, leverage_signal, btc_put_call, btc_sp500_correlation, macro_risk_appetite.
Inputs: url (required), conditions (required), label, cooldown_minutes.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 31 tools
The tools have overlapping purposes that could cause confusion, such as multiple 'get_' tools for market analysis (e.g., get_market_regime, get_reality_check, get_sentiment_state) which may seem redundant. However, descriptions provide some differentiation, like get_reality_check synthesizing all data sources, but an agent might struggle to choose the right one for specific needs without careful reading.
Tool names follow a highly consistent verb_noun pattern throughout, with 'get_', 'set_', 'evaluate_', and 'manage_' prefixes clearly indicating actions. This predictability makes it easy for agents to understand the tool's function at a glance, with no deviations in style.
With 31 tools, the count is excessive for a single server, likely overwhelming agents and causing decision paralysis. While the domain (crypto market analysis) is broad, many tools could be consolidated or grouped to reduce complexity, making it feel bloated and inefficient.
The tool set provides comprehensive coverage for crypto market analysis, including data retrieval (e.g., get_asset_context, get_macro_context), strategy evaluation, portfolio management, alerts, and webhooks. There are no obvious gaps; it supports full lifecycle operations from setup to monitoring and adjustment.
Related MCP Connectors
Market intelligence for AI agents. Real-time data, cross-market analysis, and regime detection.
Financial data for AI agents: crypto data, Polymarket odds, weather/oil calibration, trust scoring.
Polymarket + Hyperliquid + macro for AI agents. 38 tools, signal backtest, SSE streaming. Free tier.
Live crypto market signals for AI agents: perp liquidations, funding, OI positioning, yield, FX.
Related MCP Servers
- AlicenseAqualityCmaintenanceThe conviction engine for autonomous crypto trading agents. 376 metrics across 8 factor classes, multi-factor backtesting, signal persistence, and regime analysis — 21 tools for AI agents via MCP.2147 npmMIT
- AlicenseAqualityDmaintenanceAgent-ready financial intelligence tools for AI agents. Two curated tools — get_stock_snapshot and get_company_metrics — that combine multiple data sources, derive signals (UNDERVALUED, STRONG, ACCELERATING), and pre-compute the math. One call, one agent-friendly response.382 npm1MIT

Stelar Signals MCPofficial
AlicenseAqualityCmaintenanceEnables AI agents to access crypto market signals including regime, sentiment, price, risk, and text tools like summarization and fact-checking, backed by a live production-grade classifier.656 npmMIT- AlicenseBqualityFmaintenanceReal-time crypto, stock, and prediction-market data for agents — prices, indicators, funding rates, DeFi TVL, macro calendar, and an AI momentum score. Configure one Base wallet key and it just works. No signup, no dashboard, no subscription.2280 npmMIT