Fathom MCP Server

공식

AI 에이전트를 위한 금융 인텔리전스 — 정권, 파생상품, 스테이블코인 흐름, 모멘텀, 거시경제, 기상 패턴, 정치 사이클 등 8개 데이터 소스에 걸친 31개의 도구.

GitHub

문서

Fathom — AI 에이전트를 위한 금융 현실 인식

당신의 지능을 위해. 에이전트가 행동하기 전에 알아야 할 FYI.

라이브: fathom.fyi

Fathom이란?

Fathom은 AI 에이전트가 중대한 결정을 내리기 전에 금융 현실 인식 능력을 부여하는 MCP 서버입니다.

문제점: 오늘날 암호화폐 시장에서 활동하는 모든 AI 에이전트는 맹목적입니다. 트레이딩 봇은 가격을 보지만 맥락을 이해하지 못합니다. DeFi 에이전트는 우리가 사이클의 어디에 있는지 모른 채 자본을 배치합니다. 자금 관리자는 거시적 인식 없이 결정을 내립니다. 데이터는 있지만 이해가 없습니다.

해결책: Fathom은 8개의 실시간 데이터 소스를 종합하여 해석된 인텔리전스(국면 분류, 사이클 위치, 심리 상태, DeFi 건전성, 거시적 맥락, 온체인 신호)를 에이전트가 즉시 행동할 수 있는 평이한 영어 지침으로 제공합니다.

에이전트는 "BTC가 $82,000입니다"라는 정보를 받지 않습니다. 대신 "시장은 후기 단계의 위험 회피 회전 중입니다. 공포 & 탐욕 지수 28. BTC 도미넌스 상승 — 자본이 안전 자산으로 이동 중. 역사적 유사 사례: 2022년 4분기 회복 전 축적 구간. 권장 포지션: 방어적." 이라는 정보를 받습니다.

빠른 시작

설정 불필요 — 즉시 작동

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`	사용자 정의 알림 조건 정의 (예: "fear_greed < 20")
`get_alerts`	실시간 데이터에 대해 트리거된 알림 확인
`get_watchlist_report`	상태 변화 감지와 함께 최대 10개 자산 일괄 분석
`evaluate_strategy`	실시간 조건에 대해 내장 또는 사용자 정의 전략 테스트
`get_chain_context`	체인별 DeFi 인텔리전스 (이더리움, 솔라나, 베이스, 아비트럼 등)
`get_alternative_signals`	금융 중심지 날씨, 정치 사이클, 계절성, 거시적 캘린더
`get_derivatives_context`	펀딩 비율, 옵션 데이터 (풋/콜, 미결제약정, 내재 변동성, 맥스 페인), 레버리지 포지셔닝
`get_stablecoin_flows`	스테이블코인 공급 추적, 발행/소각, 자본 흐름 신호, 디페그 경고
`get_correlation_matrix`	S&P 500 및 금과의 BTC 상관관계, TradFi 가격, 거시적 위험 선호도
`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 웹훅 등록
`manage_webhooks`	활성 웹훅 나열, 모니터링, 제거

문서

문서	다루는 내용
도구 참조	모든 도구, 모든 매개변수, 모든 출력 필드
출력 예시	주요 도구에 대한 실제 JSON 출력 예시
에이전트 프롬프트 템플릿	일반적인 워크플로우를 위한 10개의 즉시 사용 가능한 프롬프트
트레이딩 봇 스켈레톤	결정 로직이 포함된 TypeScript 봇 패턴
LangChain 예시	LangChain MCP 통합

실제 워크플로우

예측 시장 봇 — 방향성을 위해 get_asset_momentum (15분 + 4시간) 호출, 펀딩 비율 + 맥스 페인을 위해 get_derivatives_context 호출, FOMC/CPI 근처 베팅 억제를 위해 get_event_catalyst_timeline 호출, 과거 정확도로 신호 가중치 부여를 위해 get_signal_history 호출.

일일 트레이딩 브리핑 — 시장 개장 시 get_reality_check 호출. risk_score > 70인 경우 익스포저 축소. suggested_posture가 "sideline"인 경우 레버리지 포지션 청산. 자본 방향 확인을 위해 get_stablecoin_flows 추가.

포트폴리오 리밸런싱 — 보유 자산으로 set_portfolio_context 실행 후 국면 정렬 제안을 위해 get_portfolio_analysis 실행. BTC와 주식 익스포저가 동일한 거시적 위험을 이중 계산하고 있는지 확인하려면 get_correlation_matrix 사용.

자동 알림 — fear_greed < 20와 같은 조건에 대해 set_alert 사용. get_alerts로 폴링. 무제한 등급에서는 조건 충족 시 봇에 직접 POST하도록 set_webhook 사용.

예시 에이전트 프롬프트

모든 거래 전에:

"get_reality_check를 사용하여 현재 시장 상황을 평가해줘. 위험 점수와 제안된 포지션은 무엇이야? 이 거래를 진행해야 할까?"

포트폴리오 점검:

"내 보유 자산으로 set_portfolio_context를 사용해줘: 2 BTC, 50 SOL, $10k USDC. 그런 다음 get_portfolio_analysis를 사용해줘 — 내 포트폴리오가 현재 국면에 정렬되어 있어?"

내러티브 조사:

"get_narrative_pulse를 사용하여 어떤 암호화폐 섹터가 가속화되고 있는지 식별해줘. 모멘텀은 어디에 있어?"

자산 실사:

"SOL에 대해 get_asset_context를 사용하고, 전체 환경에 대해 get_reality_check를 사용해줘. 지금이 좋은 진입 시점이야?"

거시적 인식:

"get_macro_context와 get_temporal_context를 사용해줘. 우리는 사이클의 어디에 있고 거시적 배경은 무엇이야?"

자본 배치 전 위험 평가:

"get_reality_check를 사용해줘. 오늘 자본을 배치하기 전에 내가 알아야 할 상위 3가지 위험은 무엇이야?"

가격

등급	가격	도구	속도 제한
무료	$0	4개 핵심 도구	시간당 10회 요청
스타터	$29/월	24개 도구 + 모멘텀 + 촉매제 + 알림 + 전략 + 키 교체	시간당 500회 요청
프로	$99/월	29개 도구 + 사용자 정의 전략 + 군중 인텔리전스	시간당 2,000회 요청
무제한	$299/월	전체 32개 + 웹훅 + 무제한 요청 + 최적화된 캐시	무제한

fathom.fyi에서 구독하기

데이터 소스

소스	제공 내용	신선도
CoinGecko	가격, 시가총액, OHLC, 카테고리, 트렌딩	실시간
Alternative.me	공포 & 탐욕 지수	실시간
DeFiLlama	DeFi TVL, 프로토콜 데이터, 스테이블코인 공급	실시간
Deribit	펀딩 비율, 옵션 미결제약정, 풋/콜, 내재 변동성, 맥스 페인	실시간
Yahoo Finance	S&P 500, 금 — TradFi 상관관계	매일
FRED	연방기금금리, DXY, 수익률 곡선	매일
Mempool.space	비트코인 네트워크 건전성, 수수료, 채굴	실시간
Open-Meteo	금융 중심지 날씨 (햇빛 효과)	실시간

라이선스

MIT