Fathom MCP Server
oficialInteligência financeira para agentes de IA — 31 ferramentas em 8 fontes de dados, incluindo regime, derivativos, fluxos de stablecoins, momentum, macro, padrões climáticos e ciclos políticos.
Documentação
Fathom — Realidade Financeira para Agentes de IA
Para Sua Inteligência. O FYI que seu agente precisa antes de agir.
Disponível em fathom.fyi
O que é o Fathom?
O Fathom é um servidor MCP que fornece aos agentes de IA consciência da realidade financeira antes que tomem decisões importantes.
O problema: Todo agente de IA operando no mercado cripto hoje está cego. Bots de trading veem preços, mas não entendem o contexto. Agentes DeFi alocam capital sem saber em que ponto do ciclo estamos. Gestores de tesouraria tomam decisões sem consciência macro. Eles têm dados, mas não têm entendimento.
A solução: O Fathom sintetiza 8 fontes de dados em tempo real em inteligência interpretada — classificação de regime, posicionamento no ciclo, estado do sentimento, saúde do DeFi, contexto macro e sinais on-chain — entregues como orientação em linguagem simples que um agente pode usar imediatamente.
Seu agente não recebe "BTC está a $82.000". Ele recebe: "O mercado está em rotação tardia de risk-off. Medo & Ganância em 28. Dominância do BTC subindo — capital migrando para segurança. Análogo histórico: zona de acumulação pré-recuperação do Q4 2022. Postura recomendada: defensiva."
Início Rápido
Configuração zero — funciona imediatamente
Adicione à configuração do seu Claude Desktop (Settings → Developer → Edit Config):
{
"mcpServers": {
"fathom": {
"command": "npx",
"args": ["-y", "fathom-fyi"]
}
}
}
Salve. Reinicie o Claude Desktop. Pergunte ao Claude: "Use o Fathom para verificar o mercado."
Pronto. Três ferramentas gratuitas, dados ao vivo, sem necessidade de chaves de API.
Cursor
Adicione ao .cursor/mcp.json:
{
"mcpServers": {
"fathom": {
"command": "npx",
"args": ["-y", "fathom-fyi"]
}
}
}
Qualquer cliente MCP
O Fathom usa transporte stdio. Aponte qualquer cliente MCP para npx -y fathom-fyi.
Desbloqueie tudo com uma chave
Assine em fathom.fyi, adicione sua chave à configuração e pronto. Uma chave desbloqueia todas as 32 ferramentas, todas as 8 fontes de dados e roteamento de dados premium. Nenhuma outra chave de API é necessária — o Fathom gerencia toda a autenticação das fontes de dados no lado do servidor.
"env": {
"FATHOM_API_KEY": "fathom_sk_your_key"
}
Ferramentas (32 instrumentos)
Nível Gratuito (4 ferramentas)
| Ferramenta | Descrição |
|---|---|
get_reality_check | Resumo de mercado com regime, sentimento, pontuação de risco. Níveis pagos adicionam sinais alternativos. |
get_market_regime | Classificação de regime (risk-on/off, eufórico, capitulação) com pontuação de confiança |
get_sentiment_state | Índice de Medo & Ganância, tendência de 7 dias, sinais contrários, detecção de oportunidade extrema |
get_account_status | Seu nível, estatísticas de uso, ferramentas bloqueadas, caminho de upgrade |
Nível Starter (25 ferramentas — $29/mês)
Todas as ferramentas gratuitas mais:
| Ferramenta | Descrição |
|---|---|
get_narrative_pulse | Rotação de setores, narrativas acelerando/desacelerando, pontuação de momentum |
get_asset_context | Contexto profundo sobre qualquer ativo: posição no ciclo, tendência, saúde do volume, nível de risco |
get_temporal_context | Posicionamento no ciclo de halving do Bitcoin com análogos históricos |
get_defi_health | TVL do ecossistema DeFi, pontuação de saúde, risco de concentração, tendências de receita |
get_macro_context | Taxas do Fed, DXY, curva de juros, probabilidade de recessão, impacto cripto |
get_onchain_pulse | Saúde da rede Bitcoin, mempool, taxas, economia de mineração |
set_portfolio_context | Salve seus ativos em carteira para orientação personalizada |
set_alert | Defina condições de alerta personalizadas (ex.: "medo_ganancia < 20") |
get_alerts | Verifique quais dos seus alertas foram acionados com dados ao vivo |
get_watchlist_report | Analise em lote até 10 ativos com detecção de mudança de estado |
evaluate_strategy | Teste estratégias integradas ou personalizadas contra condições ao vivo |
get_chain_context | Inteligência DeFi por chain (Ethereum, Solana, Base, Arbitrum, etc.) |
get_alternative_signals | Clima em centros financeiros, ciclos políticos, sazonalidade, calendário macro |
get_derivatives_context | Taxas de financiamento, dados de opções (put/call, OI, IV, max pain), posicionamento de alavancagem |
get_stablecoin_flows | Rastreamento de oferta de stablecoins, emissão/resgates, sinal de fluxo de capital, alertas de depeg |
get_correlation_matrix | Correlação do BTC com S&P 500 e Ouro, preços TradFi, apetite a risco macro |
set_signal_preferences | Personalize quais sinais alimentam sua verificação de realidade |
rotate_api_key | Rotacione sua chave de API — desativa a chave antiga, emite uma nova |
get_asset_momentum | Momentum de curto prazo (15m/1h/4h/1d/7d). RSI, percentil ATR, largura de banda de Bollinger, estado de volatilidade, pontuação de confiança, trajetória de financiamento |
get_event_catalyst_timeline | Catalisadores futuros: FOMC, CPI, empregos, vencimento de opções, quad witching. Classificação de impacto, direção esperada, notas de trading |
get_question_context | Enriqueça qualquer pergunta sim/não com sinais relevantes do Fathom. Detecta automaticamente tópicos macro, políticos, cripto e de derivativos. Construído para bots de mercado de previsão. |
Nível Pro (30 ferramentas — $99/mês)
Todas as ferramentas Starter mais:
| Ferramenta | Descrição |
|---|---|
get_portfolio_analysis | Análise personalizada de portfólio com alinhamento de regime e rebalanceamento |
get_crowd_intelligence | Comportamento agregado de todos os agentes conectados ao Fathom |
get_signal_history | Histórico do Fathom: cada sinal registrado, resultados rastreados |
get_historical_context | Quais eram as condições de mercado em qualquer data passada? |
set_custom_strategy | Crie estratégias de trading personalizadas com suas próprias regras de condição |
Nível Unlimited (32 ferramentas — $299/mês)
Todas as ferramentas Pro mais:
| Ferramenta | Descrição |
|---|---|
set_webhook | Registre webhooks HTTP que disparam quando as condições de mercado atendem aos seus critérios |
manage_webhooks | Liste, monitore e remova webhooks ativos |
Documentação
| Documento | O que cobre |
|---|---|
| Referência de Ferramentas | Cada ferramenta, cada parâmetro, cada campo de saída |
| Exemplos de Saída | Exemplos reais de saída JSON para ferramentas principais |
| Modelos de Prompt para Agentes | 10 prompts prontos para uso em fluxos de trabalho comuns |
| Esqueleto de Bot de Trading | Padrão de bot TypeScript com lógica de decisão |
| Exemplo LangChain | Integração MCP com LangChain |
Fluxos de Trabalho do Mundo Real
Bot de Mercado de Previsão — Chame get_asset_momentum (15m + 4h) para direção, get_derivatives_context para taxas de financiamento + max pain, get_event_catalyst_timeline para suprimir apostas próximas a FOMC/CPI, e get_signal_history para ponderar sinais pela precisão passada.
Briefing Diário de Trading — Chame get_reality_check na abertura do mercado. Se risk_score > 70, reduza a exposição. Se suggested_posture for "à margem", feche posições alavancadas. Adicione get_stablecoin_flows para confirmar a direção do capital.
Rebalanceamento de Portfólio — set_portfolio_context com seus ativos, depois get_portfolio_analysis para sugestões alinhadas ao regime. Use get_correlation_matrix para verificar se sua exposição a BTC e ações está contando duas vezes o mesmo risco macro.
Alertas Automatizados — set_alert para condições como fear_greed < 20. Consulte com get_alerts. No nível Unlimited, set_webhook para enviar POST diretamente ao seu bot quando as condições forem atendidas.
Exemplos de Prompts para Agentes
Antes de qualquer trade:
"Use get_reality_check para avaliar as condições atuais do mercado. Qual é a pontuação de risco e a postura sugerida? Devo prosseguir com este trade?"
Verificação de portfólio:
"Use set_portfolio_context com meus ativos: 2 BTC, 50 SOL, $10k USDC. Depois use get_portfolio_analysis — meu portfólio está alinhado com o regime atual?"
Pesquisa de narrativas:
"Use get_narrative_pulse para identificar quais setores cripto estão acelerando. Onde está o momentum?"
Due diligence de ativos:
"Use get_asset_context para SOL, depois get_reality_check para o ambiente geral. Este é um bom ponto de entrada?"
Consciência macro:
"Use get_macro_context e get_temporal_context. Onde estamos no ciclo e qual é o cenário macro?"
Avaliação de risco antes de alocar capital:
"Use get_reality_check. Quais são os 3 principais riscos que devo conhecer antes de alocar capital hoje?"
Preços
| Nível | Preço | Ferramentas | Limite de Requisições |
|---|---|---|---|
| Gratuito | $0 | 4 ferramentas principais | 10 req/h |
| Starter | $29/mês | 24 ferramentas + momentum + catalisadores + alertas + estratégias + rotação de chave | 500 req/h |
| Pro | $99/mês | 29 ferramentas + estratégias personalizadas + inteligência coletiva | 2.000 req/h |
| Unlimited | $299/mês | Todas as 32 + webhooks + requisições ilimitadas + cache otimizado | Ilimitado |
Fontes de Dados
| Fonte | O que fornece | Atualização |
|---|---|---|
| CoinGecko | Preços, capitalização de mercado, OHLC, categorias, tendências | Tempo real |
| Alternative.me | Índice de Medo & Ganância | Tempo real |
| DeFiLlama | TVL DeFi, dados de protocolos, oferta de stablecoins | Tempo real |
| Deribit | Taxas de financiamento, OI de opções, put/call, vol implícita, max pain | Tempo real |
| Yahoo Finance | S&P 500, Ouro — correlação TradFi | Diário |
| FRED | Taxa de Fundos do Fed, DXY, curva de juros | Diário |
| Mempool.space | Saúde da rede Bitcoin, taxas, mineração | Tempo real |
| Open-Meteo | Clima em centros financeiros (efeito sol) | Tempo real |
Licença
MIT