FalsifyLab Alpha

8 ferramentas de dados que fornecem alpha de cripto + ações dos EUA para agentes de IA via MCP

Documentação

falsifylab-alpha-mcp

FalsifyLab Alpha: 13 live finance MCP tools for AI coding agents

Camada de dados MCP para pesquisa de mercado assistida por IA. 13 ferramentas financeiras ao vivo que se integram ao Claude Code, Cursor, Cline, Windsurf ou qualquer cliente compatível com MCP. O plano gratuito não exige cadastro.

Não é um serviço de sinais. Não é aconselhamento de investimento. Dados públicos de mercado com leve enriquecimento para agentes de IA. Faça backtest antes de agir.

Duas formas de usar

Opção 1: MCP hospedado (sem instalação). Aponte seu agente para o endpoint hospedado, sem necessidade de Python.

{
  "mcpServers": {
    "falsifylab-alpha": {
      "url": "https://mcp.falsifylab.com/"
    }
  }
}

O plano gratuito é aplicado automaticamente. Fluxo OAuth 2.1 + PKCE para o plano pago via Whop. Transporte HTTP streamable. Especificação OpenAPI 3.1 completa em https://docs.falsifylab.com/openapi.html.

Opção 2: stdio (este pacote).

pip install falsifylab-alpha-mcp

Zero dependências em tempo de execução (apenas stdlib do Python). Depois, conecte ao seu agente. Veja configuração do cliente.

O que faz

Quando o usuário pergunta ao seu agente de IA coisas como:

"Que clusters de insider estão se formando hoje?"
"Mostre vaults da Hyperliquid com Sharpe alto e drawdown <10%"
"Os fluxos de ETF de BTC estão confirmando ou divergindo da ação do preço?"
"O que está no tape macro agora?"
"Encontre baleias da Polymarket com taxa de vitória acima de 60%"

...o agente chama uma das 13 ferramentas e fundamenta a resposta em números em tempo real de dados públicos de mercado — em vez de especular com base no conhecimento de treinamento.

As 13 ferramentas

Ferramenta	Retorna	Caso de uso
`top_yield_farms`	Rendimentos DeFi com emissões removidas, risco de IL precificado	Encontre rendimento real, não rendimento de manchete
`hl_vault_leaderboard`	Vaults da Hyperliquid por NAV / 30d / drawdown / score	Referência para copy-trade
`insider_buy_clusters`	Compras em cluster do Formulário 4 da SEC (3+ insiders, janela de 24h)	Sinal de convicção em ações
`sec8k_material_today`	Arquivos 8-K filtrados por códigos de itens materiais	Lucros, M&A, mudanças de executivos
`macro_tape`	Snapshot de SPX/NDX/VIX/UST/DXY/GOLD/WTI/BTC/ETH	Portão de regime para ideias de trade
`etf_flow_today`	Agregados de ETF spot de BTC + ETH nos EUA	Posicionamento institucional
`active_airdrop_farms`	Airdrops de yield-gap da DefiLlama	Farms onde você é pago para esperar
`polymarket_whale_positions`	Principais carteiras + posições ativas	Copy-trade em mercados de previsão
`earnings_drift_radar`	Derivação pós-lucros + candidatos a IV crush	Scanner de volatilidade em eventos de ações
`token_unlock_radar`	Cronograma futuro de desbloqueio de tokens + tamanho	Radar de risco de excesso de oferta
`fed_comm_radar`	Janelas de volatilidade de eventos/falas do Fed	Scanner de risco de eventos macro
`confluence_today`	Alinhamento de sinais entre fontes	Empilha 2+ sinais no mesmo ativo
`onchain_smart_wallets`	Scores ao vivo de bots de copy-trade na Solana	Rankings de carteiras de produção

Todas as ferramentas têm esquemas JSON completos expostos em /.well-known/mcp/server-card.json.

Configuração do cliente

Claude Code

claude mcp add falsifylab-alpha -- python -m falsifylab_alpha_mcp

Para o plano Pro:

claude mcp add falsifylab-alpha \
  --env FL_API_KEY=fl_your_key \
  -- python -m falsifylab_alpha_mcp

Cursor

Cole em ~/.cursor/mcp.json ou na raiz do workspace .mcp.json:

{
  "mcpServers": {
    "falsifylab-alpha": {
      "command": "python",
      "args": ["-m", "falsifylab_alpha_mcp"],
      "env": {
        "FL_API_KEY": "fl_your_key_or_omit_for_free_tier"
      }
    }
  }
}

Reinicie o Cursor. As ferramentas são descobertas automaticamente.

Cline

Configurações → Servidores MCP → Adicionar servidor. Cole o mesmo JSON do Cursor acima.

Windsurf

Configurações → MCP. Mesma configuração JSON. Indexado automaticamente pela Smithery em até 48h.

Smithery

Conecte pelo gateway hospedado da Smithery — sem necessidade de instalação local de Python. Veja smithery.ai/servers/falsifylab/falsifylab-alpha-mcp.

Verifique a instalação

No seu agente, pergunte:

Use macro_tape. Mostre SPX, VIX, BTC, ETH com retornos de 1d e 5d.

Se o agente retornar números, você está conectado.

Prompts de agente prontos

Copie e cole estes. Funcionam na primeira execução.

Brief macro diário:

Use macro_tape. Tell me the macro regime in 3 sentences. Cite specific
numbers — last price, 1d return, 5d return. Then list 2 tickers from
sec8k_material_today that might benefit from this regime.

Empilhador de insider + 8-K:

Run insider_buy_clusters (min_insiders=3) and sec8k_material_today
(items=["2.02","8.01","5.02"]). Find tickers in both within 24h. For
each match, summarize what insiders bought and what the 8-K said. End
with the bear case in one sentence.

Varredura de confluência com cenário de baixa:

Use confluence_today with min_signals=2. For each asset/ticker, explain
why these signals stacking is meaningful in 2 sentences. Skip noise
(DeFi LP pools with stablecoins). Highlight the most contrarian stack.

Mais 8 receitas em falsifylab.com/cookbook.

Preços

Plano	Preço	O que inclui
Free	$0	Cache de 24h, 10 resultados/consulta, sem cadastro, 60 req/h
Pro	$19/mês	Tempo real (5min), 100 resultados/consulta, histórico de 90d, sem limite de taxa
Pro Plus	$49/mês	Atualização de 1 min, alertas por email + Slack, 365d em feeds de ações, webhooks
Teams	$199/mês	5 assentos, 50k req/dia, suporte prioritário

Promoção de lançamento EARLY50: 50% de desconto nos primeiros 3 meses, limitado a 25 resgates. Obtenha uma chave em falsifylab.com/pro.

Demonstração ao vivo

Agente público chamando essas ferramentas a cada 15 minutos: falsifylab.com/demo. Mesmo servidor MCP que você instalaria. Números reais, sem curadoria.

Por que isso existe

Construído porque o autor raspava manualmente SEC EDGAR e DefiLlama às 6h da manhã todos os dias para alimentar uma frota de bots de trading. Os bots que sobreviveram se alimentaram exatamente deste pipeline. Foi empacotado como um servidor MCP para que qualquer agente possa puxar os mesmos dados.

Os comprovantes da frota de bots (vivos + mortos, P&L, drawdown) são públicos em falsifylab.com/vaults.

Transparência

O que fazemos: agregamos e enriquecemos levemente dados públicos de mercado, expostos via MCP
O que não fazemos: execução de trades, corretagem, consultoria, venda de sinais
Fontes de dados: SEC EDGAR (Formulário 4, 8-K), SoSoValue (fluxos de ETF), DefiLlama (rendimentos), API pública da Hyperliquid, API pública da Polymarket, Yahoo Finance (macro)
Privacidade: chave do plano gratuito emitida por hash(IP+UA), não armazenada a longo prazo. Corpos de requisição nunca são registrados.

Telemetria

O servidor stdio local grava linhas JSONL de telemetria mínima por ferramenta em:

/var/log/falsifylab/mcp_tool_calls.jsonl (substitua com FL_MCP_TOOL_CALL_LOG)

Cada linha inclui apenas:

ts, tool, args_keys (apenas nomes de argumentos), has_api_key, key_hash (prefixo sha256), version

Nunca registrados por este caminho de telemetria:

chaves de API brutas
valores de argumentos / corpos de requisição
endereço IP
email / nome / outros identificadores de usuário

Para desativar a telemetria completamente:

export FL_DISABLE_TELEMETRY=1

O que funciona, o que não funciona

Lista honesta. Atualizada a cada lançamento.

O que funciona hoje

Todas as 13 ferramentas retornam dados ao vivo em chamadas de agente abaixo de 1s p95.
O plano gratuito tem zero atrito de cadastro. Nenhuma chave de API necessária para o caminho em cache.
Clusters de insider do Formulário 4 são atualizados a cada 15 min em dias úteis diretamente do SEC EDGAR, sem revendedor de terceiros no pipeline.
Os rendimentos da DefiLlama são ajustados por emissões (APY de manchete menos tokens de recompensa), então uma farm de 200% e outra de 200% não são mais o mesmo número.
As atualizações de NAV dos vaults da Hyperliquid chegam ao nosso espelho R2 em até 60s do ticker de origem.
Entrega de webhooks Telegram + Slack no Pro Plus é pontual dentro da janela do cron. Sem filas de backup no mês de lançamento.

O que não funciona (ainda)

A lista de arquivos materiais 8-K fica vazia nos fins de semana porque a SEC não arquiva. Retorna count: 0 Sáb/Dom. Esperado.
O tape macro usa endpoints gratuitos do Yahoo Finance. Lacuna intradiária de 15-20 min durante o horário de mercado dos EUA. Planejamos trocar por um feed pago no plano Teams, não antes.
onchain_smart_wallets cobre apenas Solana por enquanto. Scores de copy-trade para Base + Ethereum estão na fila para v0.3.x.
O cache do plano gratuito é de 24h. Então confluence_today em uma chave gratuita mostra a confluência de ontem, não a de hoje. O plano Pro de $19/mês acessa dados ao vivo.
Replay histórico em vários trimestres não está na v0.2.x. Rastreado como item de roadmap.
Ainda não há SDK para TypeScript ou Go. Apenas servidor MCP em Python. Use transporte stdio de qualquer cliente compatível com MCP enquanto isso.

O que já matamos

Assinaturas diretas via Stripe Connect (bloqueio de KYC do operador). Whop é o caminho.
Plano pago no Substack (dependência do Stripe).
Uma versão anterior do pacote 0.2.0 enviou um host api.falsifylab.com quebrado. Corrigido na 0.2.1 em 4 dias. Desculpas se você pegou a 0.2.0 primeiro.

Se encontrar algo quebrado, envie DM para a conta FL no X ou abra uma issue. Corrigimos bugs que bloqueiam produção no mesmo dia.

Arquitetura

your AI agent
    ↓ (MCP stdio)
falsifylab_alpha_mcp (Python stdlib, no deps)
    ↓ (HTTPS)
falsifylab.com/api/* (Cloudflare Workers)
    ↓ (cached 60s-1hr)
R2 (data feeds refreshed every 15min via cron)
    ↓ (every 15min)
Backend cron scripts (Form 4, 8-K, ETF, yield, polymarket, onchain, etc.)

O plano gratuito acessa dados em cache com idade de 24h. O plano Pro acessa os mesmos endpoints com cabeçalho de autenticação, ignorando o cache para dados frescos da fonte.

Suporte

Issues: Issues no GitHub
Email: ops@falsifylab.com
Segurança: relate para ops@falsifylab.com com assunto [security]. Resposta em 48h. Divulgação responsável creditada no CHANGELOG.

Contribuindo

PRs são bem-vindos para:

Novas ideias de ferramentas (abra uma issue primeiro para discutir o escopo)
Melhorias na documentação
Correções de bugs

Não envie PRs para geradores de sinais de trading ou auxiliares de copy-trading — fora do escopo deste servidor (somos infraestrutura de dados de pesquisa, não consultoria).

Licença

MIT. Veja LICENSE.

FalsifyLab Alpha v0.3.3 · Construído para agentes de codificação com IA · Plano gratuito sem cadastro · falsifylab.com

FalsifyLab Alpha

Documentação