MCP SERVERGet one crypto briefing that folds regime, halving cycle, DeFi health, macro, sentiment, on-chain activity and narrative rotation into a single answer, then wire alerts to the same signals.
LABSCO SUMMARY
The shape of the tool set is a briefing engine: one call synthesizes, the rest let you drill into whichever domain the briefing flagged, and set_signal_preferences decides which of them count. get_crowd_intelligence and get_signal_history carry a [BETA] marker in their own descriptions — the first scales with network size, the second says accuracy scoring is still under development — so they read differently from the price and on-chain calls. Tiering is visible in the product itself: get_account_status lists locked tools alongside available ones.
A market-intelligence server over Fathom's crypto signal set, with per-domain reads, a synthesis call, portfolio-aware analysis and condition-triggered alerts
A Fathom account: get_account_status reports the current tier, requests used this hour and which tools are locked, and rotate_api_key names Starter tier or above. get_portfolio_analysis returns nothing until set_portfolio_context has been called.
One command — npx -y fathom-fyi
USE CASES
One synthesis call returns the posture with its evidence; the regime and sentiment reads behind it show whether the call rests on positioning, on fear, or on the cycle.
Once holdings are stored, the analysis reads them against current conditions: allocation, PnL, concentration risk, whether the book matches the regime, and what to rebalance.
Alerts hold thresholds you can check on demand; webhooks push instead, evaluated every 60 seconds and POSTed to your URL only when every condition is met.
Asset context covers cycle position, holder behaviour and risk level; the momentum read adds direction, RSI, volatility state and a confidence score on a chosen timeframe.
Funding, options and leverage tell you how crowded the trade is, the catalyst timeline says what is coming, and stablecoin flows say whether capital is arriving or leaving.
Built-in strategies such as fear_accumulator or macro_aligned can be scored against current conditions, and a strategy of your own is evaluated the same way once defined.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
evaluate_strategyEvaluate 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.
get_account_statusCheck your Fathom account: current tier, requests used this hour, available and locked tools, cache freshness, and upgrade options. Available on all tiers including free.
get_alertsCheck which of your configured alerts are currently triggered. Evaluates all alert conditions against live market data.
get_alternative_signalsUnconventional 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.
get_asset_contextGet 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").
get_asset_momentumShort-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.
get_chain_contextGet 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.
get_correlation_matrixBTC 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.
get_crowd_intelligence[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.
get_defi_healthAssess DeFi ecosystem health: total TVL, TVL trends, top chains and protocols, health score, revenue trends, and ecosystem concentration risk.
get_derivatives_contextDerivatives 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.
get_event_catalyst_timelineUpcoming 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.
get_historical_contextLook 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.
get_macro_contextGet macro economic context for crypto: Federal Funds Rate, DXY (dollar strength), yield curve, recession probability, and net macro impact on crypto.
get_market_regimeClassify the current crypto market regime (risk-on, risk-off, transitional, euphoric, capitulation) with confidence score, evidence, historical analog, and actionable agent guidance.
get_narrative_pulseIdentify accelerating, decelerating, and emerging crypto narratives. Shows sector rotation, momentum scores, and narrative cycle phase for positioning.
get_onchain_pulseGet Bitcoin on-chain health: mempool congestion, fees, miner distribution, network security, mining economics, and activity levels.
get_portfolio_analysisGet 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.
get_question_contextEnrich any binary yes/no question with relevant Fathom signals. Auto-detects if the question is macro, political, crypto, or derivatives-related and returns all relevant signals, upcoming catalysts, and historical context. Designed for prediction market bots — call this for any Polymarket question to give your LLM the context it needs to estimate probability.
get_reality_checkThe 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.
get_sentiment_stateGet the current crypto sentiment state including Fear & Greed Index, 7-day trend, contrarian signals, and whether extreme fear/greed opportunities are active.
get_signal_history[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.
get_stablecoin_flowsTrack 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.
get_temporal_contextGet Bitcoin halving cycle positioning: days since last halving, estimated cycle phase, historical analogs from cycles 1-3, and cycle-based guidance.
get_watchlist_reportAnalyze multiple assets at once. Returns cycle position, risk level, and volume health for each. Detects state changes since last check. Max 10 assets.
manage_webhooksList 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.
rotate_api_keyRotate 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.
set_alertSet 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.
set_custom_strategyCreate a custom trading strategy with your own conditions. Then use evaluate_strategy to test it against current market conditions.
set_portfolio_contextSave 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}].
set_signal_preferencesCustomize 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.
set_webhookRegister 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.
BEFORE YOU INSTALL
32 tools when we connected. Without a key only four tools are available: get_reality_check, get_market_regime, get_sentiment_state, get_account_status. Starter ($29/mo) reaches 25, Pro ($99/mo) 30, and all 32 need Unlimited ($299/mo).
npx on PATH
All 3 documented clients run the server on your machine.
CONTEXT COST
Rated by the size of the 32 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
npx -y fathom-fyi{
"mcpServers": {
"fathom": {
"command": "npx",
"args": [
"-y",
"fathom-fyi"
]
}
}
}{
"mcpServers": {
"fathom": {
"command": "npx",
"args": [
"-y",
"fathom-fyi"
],
"env": {
"FATHOM_API_KEY": "<YOUR_FATHOM_API_KEY>"
}
}
}
}MCP servers
VGSTAAD
hive-intel
hypeprinter007-stack
coinpaprika