Fathom Fyi MCP Server

Financial Reality for AI Agents — The FYI your agent needs before it acts.

Local serverstdioTypeScript

What is the Fathom Fyi MCP Server?

Financial Reality for AI Agents — The FYI your agent needs before it acts.

The short version

Fathom is an MCP server that gives AI agents financial reality awareness before they make consequential decisions.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
get_reality_checkMarket briefing with regime, sentiment, risk score. Paid tiers add alternative signals.
get_market_regimeRegime classification (risk-on/off, euphoric, capitulation) with confidence scoring
get_sentiment_stateFear & Greed Index, 7-day trend, contrarian signals, extreme opportunity detection
get_account_statusYour tier, usage stats, locked tools, upgrade path
get_narrative_pulseSector rotation, accelerating/decelerating narratives, momentum scoring
get_asset_contextDeep context on any asset: cycle position, trend, volume health, risk level
get_temporal_contextBitcoin halving cycle positioning with historical analogs
get_defi_healthDeFi ecosystem TVL, health score, concentration risk, revenue trends
get_macro_contextFed rates, DXY, yield curve, recession probability, crypto impact
get_onchain_pulseBitcoin network health, mempool, fees, mining economics
set_portfolio_contextSave your portfolio holdings for personalized guidance
set_alertDefine custom alert conditions (e.g., "fear_greed < 20")
get_alertsCheck which of your alerts are triggered against live data
get_watchlist_reportBatch analyze up to 10 assets with state change detection
evaluate_strategyTest built-in or custom strategies against live conditions
get_chain_contextPer-chain DeFi intelligence (Ethereum, Solana, Base, Arbitrum, etc.)
get_alternative_signalsWeather in financial centers, political cycles, seasonality, macro calendar
get_derivatives_contextFunding rates, options data (put/call, OI, IV, max pain), leverage positioning
get_stablecoin_flowsStablecoin supply tracking, minting/redemptions, capital flow signal, depeg warnings
get_correlation_matrixBTC correlation with S&P 500 and Gold, TradFi prices, macro risk appetite
set_signal_preferencesCustomize which signals feed into your reality check
rotate_api_keyRotate your API key — deactivates old key, issues new one
get_asset_momentumShort-term momentum (15m/1h/4h/1d/7d). RSI, ATR percentile, Bollinger bandwidth, volatility state, confidence score, funding trajectory
get_event_catalyst_timelineUpcoming catalysts: FOMC, CPI, jobs, options expiry, quad witching. Impact rating, expected direction, trading notes
get_question_contextEnrich any yes/no question with relevant Fathom signals. Auto-detects macro, political, crypto, derivatives topics. Built for prediction market bots.
get_portfolio_analysisPersonalized portfolio analysis with regime alignment and rebalancing
get_crowd_intelligenceAggregate behavior of all Fathom-connected agents
get_signal_historyFathom's track record: every signal logged, outcomes tracked
get_historical_contextWhat were market conditions on any past date?
set_custom_strategyCreate custom trading strategies with your own condition rules
set_webhookRegister HTTP webhooks that fire when market conditions meet your criteria
manage_webhooksList, monitor, and remove active webhooks

How to install the Fathom Fyi MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

Example prompts to try

  • “Use Fathom Fyi to get reality check.”
  • “Use Fathom Fyi to get market regime.”
  • “Use Fathom Fyi to get sentiment state.”

Frequently asked questions

Financial Reality for AI Agents — The FYI your agent needs before it acts. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.