PreReason

O PreReason dá ao agente de IA um contexto de mercado com o qual ele pode raciocinar, em vez de números brutos. Uma chamada retorna um briefing com a análise já incluída: uma linha de sinal, direção de tendência em várias janelas, pontuações de confiança, classificações de percentil e correlações, e nos briefings mais aprofundados um rótulo de regime e uma narrativa em linguagem simples. Os briefings cobrem Bitcoin, liquidez macro, FX e correlações entre ativos. O catálogo contém 19 briefings ativos e 212 métricas individuais, entre elas preço e momentum do Bitcoin, saúde da rede e dos mineradores, fluxos de ETF spot de Bitcoin, tesourarias corporativas de Bitcoin, balanço do Fed, M2, liquidez líquida, rendimentos de títulos do Tesouro e o dólar. É servido via MCP (um servidor remoto e uma ponte npm) e via REST, como Markdown ou JSON. As ferramentas do catálogo não precisam de chave, e um agente pode obter uma chave gratuita dentro da sessão: ele mostra um link, uma pessoa o aprova, e a chave chega.

Início Rápido

Opção 1: Claude Desktop, sem necessidade de chave

Requer Node.js 18+, e nada mais: a ponte não tem dependências.

Adicione isto a claude_desktop_config.json e reinicie o Claude Desktop:

{
  "mcpServers": {
    "prereason": {
      "command": "npx",
      "args": ["-y", "@prereason/mcp"],
      "env": { "PREREASON_CLIENT": "claude-desktop" }
    }
  }
}

As ferramentas do catálogo funcionam imediatamente. Na primeira vez que um briefing precisar de uma chave, a ponte solicita acesso: peça qualquer briefing ao Claude e a resposta começa com Approve at https://www.prereason.com/claim/PR-XXXX-XXXX. Abra o link, faça login ou crie uma conta gratuita, clique em Aprovar. A chave chega na ponte automaticamente, é salva em ~/.prereason/credentials.json, e a próxima chamada funciona. Nada é criado na sua conta até você clicar em Aprovar. Se sua conta já tiver o número máximo de chaves de API permitido, a resposta informa isso em vez de entrar em loop: revogue uma chave em Configurações no prereason.com e reinicie o Claude, ou defina PREREASON_API_KEY com uma chave que você já possui.

Localização do arquivo de configuração:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Já tem uma chave? Adicione-a ao bloco env como "PREREASON_API_KEY": "pr_live_..." e a ponte nunca solicitará.

Opção 2: HTTP direto com chave de API (Claude Code, Cursor, Windsurf, Codex, Gemini CLI, VS Code, scripts)

Clientes que gerenciam sua própria configuração podem chamar o endpoint diretamente, com a chave como cabeçalho:

# Claude Code
claude mcp add --transport http prereason https://api.prereason.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

{
  "mcpServers": {
    "prereason": {
      "type": "http",
      "url": "https://api.prereason.com/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

O Windsurf usa serverUrl em vez de url; o Gemini CLI usa httpUrl; o Codex usa url mais bearer_token_env_var em config.toml. Ainda não tem chave? Aponte o cliente para o endpoint sem cabeçalho para navegar no catálogo, depois crie uma chave no site (abaixo) e adicione o cabeçalho.

Opção 3: Conector personalizado para Claude.ai e Claude Desktop

Adicione PreReason como conector personalizado, escolha "Sem login" e, onde a seção de cabeçalhos de solicitação estiver disponível, adicione Authorization com o valor Bearer YOUR_API_KEY (a palavra Bearer e o espaço fazem parte do valor). O suporte a login para conectores está sendo re-testado e não é oferecido até ser verificado.

Obtenha uma Chave de API

Três maneiras, todas gratuitas. O servidor hospedado nunca entrega uma chave dentro de uma sessão e nunca solicita uma.

Através desta ponte. Execute-a sem chave definida: ela solicita acesso ao PreReason em seu nome e mostra um approve_url, em seu log e antes de qualquer resposta que precise de chave. Abra-o, faça login ou crie sua conta, clique em Aprovar, e a ponte salva a chave, vinculada à sua conta e nomeada Agent: <client_name>.

A partir do código, para um agente sem navegador. POST https://api.prereason.com/api/agent/claims (sem autenticação), mostre ao humano o approve_url, depois consulte GET https://api.prereason.com/api/agent/claims/{claim_code} com Authorization: Bearer <claim_token> até que status seja approved. Documentação: prereason.com/docs#agent-access.

No site. Cadastre-se em prereason.com/signup, depois Dashboard > Configurações > Chaves de API. As chaves começam com pr_live_.

5 Ferramentas MCP

Ferramenta	Autenticação	Descrição
list_briefings	Aberta	Lista todos os 19 briefings de mercado pré-racionalizados com requisitos de nível
list_metrics	Aberta	Lista todas as métricas disponíveis nas categorias bitcoin, macro, calculadas e eth
get_health	Aberta	Verificação de saúde da API, versão, nível da conta
get_context	Obrigatória	Busca um briefing de mercado pré-racionalizado (markdown ou JSON)
get_metric	Obrigatória	Busca uma única métrica com tendência/sinal/percentil

19 Briefings de Mercado

Gratuitos (6 briefings)

Briefing	Descrição
btc.quick-check	Contexto rápido mínimo: BTC + Liquidez Líquida + correlação
btc.context	BTC + liquidez + hash ribbon + dificuldade + momentum
macro.snapshot	Balanço do Fed, M2, rendimentos de títulos do Tesouro, força do dólar, liquidez líquida
cross.correlations	Matriz de correlação do BTC vs indicadores macro
btc.pulse	Preço, variação em 24h, dominância do Bitcoin
btc.grid-stress	Ritmo de época e previsão de ajuste de dificuldade

Basic - US$ 19,99/mês (6 briefings)

Briefing	Descrição
btc.momentum	Suporte/resistência de média móvel de 200 dias com momentum de 7d/30d/90d e classificações de percentil
macro.liquidity	Indicadores de liquidez com análise de momentum
btc.on-chain	Taxa de hash, dificuldade, transações, endereços ativos
cross.breadth	Amplitude entre SPY, QQQ e IWM, com correlação do Bitcoin com cada um
btc.miner-survival	Termômetro de hashprice com pontuação de estresse do minerador
btc.etf-flows	Fluxos líquidos diários de ETF spot de BTC, AUM agregado e detalhamento por emissor

Pro - US$ 49,99/mês (7 briefings)

Briefing	Descrição
btc.full	Análise completa do Bitcoin: sobreposição macro, momentum, percentis, correlações e narrativa
btc.factors	Atribuição multifatorial para movimentos de preço do BTC
cross.regime	Classificação de regime (risk-on/risk-off/transição) com sentimento de risco USDT.D
fx.liquidity	EUR/USD, USD/CNY e força do dólar, com liquidez líquida e correlações com Bitcoin
btc.energy	Modelo de custo de produção com pressão de entrada de gás
btc.treasury	Inteligência de tesouraria corporativa de Bitcoin a partir de arquivamentos na SEC
macro.rates	Curva de rendimento par do Tesouro em todos os vencimentos, de 1M a 30A, inflação de equilíbrio, forward 5a5a, Alemanha 10A

Exemplos de Prompts

Depois de conectado, experimente prompts como:

• "Me dê a verificação rápida do Bitcoin"
• "Mostre-me o instantâneo macro"
• "O que o briefing de contexto do BTC diz sobre as condições de mercado?"
• "Obtenha a métrica de preço do bitcoin com análise de tendência"
• "Qual é o sinal do hash ribbon agora?"
• "Liste os briefings disponíveis"

Solução de Problemas

Erro "Servidor desconectado"

• Garanta que o Node.js 18+ esteja instalado: node --version
• Verifique se sua chave de API começa com pr_live_
• Saia completamente do Claude Desktop (bandeja do sistema > Sair) e reabra

Ferramentas não aparecendo

• Reinicie o Claude Desktop após editar a configuração
• Verifique a sintaxe JSON: node -e "JSON.parse(require('fs').readFileSync('path/to/config','utf8'))"

Windows: "'C:\Program' não é reconhecido"

Se você ainda vir este erro, garanta que está usando o bloco env (não --header args) como mostrado no Início Rápido acima. Se o problema persistir, instale globalmente e use node:

1. Execute: npm install -g @prereason/mcp
2. Use esta configuração (substitua YOUR_USER pelo seu nome de usuário do Windows):

{
  "mcpServers": {
    "prereason": {
      "command": "node",
      "args": [
        "C:\\Users\\YOUR_USER\\AppData\\Roaming\\npm\\node_modules\\@prereason\\mcp\\bin\\cli.js"
      ],
      "env": {
        "PREREASON_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Erros de autenticação em get_context / get_metric

• list_briefings, list_metrics e get_health funcionam sem chave
• get_context e get_metric exigem uma chave de API válida
• Obtenha uma chave gratuita em prereason.com/signup

Outros Clientes MCP

Se seu cliente suporta servidores HTTP remotos, use a Opção 2 do Início Rápido acima. O pacote da ponte stdio só é necessário para clientes que exigem transporte stdio (ex.: Claude Desktop).

Uso via CLI

# No key: the bridge asks for access and prints one link to approve
npx @prereason/mcp

# Ask for access now, save the key, exit (useful before a first run)
npx @prereason/mcp --login

# Forget the saved key
npx @prereason/mcp --logout

# Use a key from the environment (never asks)
PREREASON_API_KEY=pr_live_... npx @prereason/mcp

# Name the app the bridge runs in, so your dashboard names the connection
PREREASON_CLIENT=claude-desktop npx @prereason/mcp

# --header (backward compatible), a custom credentials file, a custom endpoint
npx @prereason/mcp --header "Authorization:Bearer YOUR_API_KEY"
npx @prereason/mcp --credentials-file /path/to/credentials.json
PREREASON_URL=https://custom.endpoint/mcp npx @prereason/mcp

npx @prereason/mcp --help

Precedência de chave: PREREASON_API_KEY, depois --header, depois o arquivo de credenciais (~/.prereason/credentials.json, ou PREREASON_CREDENTIALS_FILE, ou --credentials-file), depois o fluxo de solicitação. O arquivo contém a chave e qual solicitação a emitiu, nunca um token de solicitação. No macOS e Linux, o diretório é criado com 0700 e o arquivo com 0600; o Windows não tem bits de modo, então o arquivo depende das permissões do diretório do seu perfil, como qualquer outro armazenamento de credenciais lá.

Extensão do Claude Desktop (.mcpb)

mcpb/manifest.json descreve a mesma ponte como uma extensão do Claude Desktop de um clique, com chave opcional. Para construir o pacote: npm install --omit=dev, depois npx @anthropic-ai/mcpb pack . a partir do diretório do pacote, e instale o .mcpb resultante clicando duas vezes nele. A submissão ao diretório do Claude passa pelo formulário de extensão do desktop e é uma decisão do editor.

Sem dependências

A ponte traz seus próprios transportes e não instala nada. npm ls nela é uma linha, npx @prereason/mcp busca um tarball de 23 KB e inicia, e o código que uma revisão de segurança precisa ler é o código neste repositório.

Antes, dependia de @modelcontextprotocol/sdk para duas classes, um transporte stdio e um cliente HTTP Streamable. Isso puxava 91 pacotes e 25 MB em disco, quase tudo da metade do servidor do SDK: Express, Hono, CORS, um limitador de taxa, um cliente OAuth e um validador de esquema, nenhum dos quais um relay jamais chama. lib/stdio.js e lib/streamable-http.js substituem as duas classes que a ponte usava, mantêm seu enquadramento e seus callbacks, e são cobertos pela suíte em test/.

Links

• Documentação
• Cadastro
• Descoberta de API
• Termos de Serviço
• Política de Privacidade

Política de Privacidade

Veja prereason.com/privacy para práticas de tratamento de dados.

Licença

MIT