Market Intelligence MCP

Market Intelligence MCP Server

Probabilidade de recessão, rotação setorial, posicionamento institucional, análise de cenários em cascata macro, calculadoras imobiliárias e dados econômicos em tempo real — para Claude, ChatGPT, Cursor e qualquer cliente MCP.

Desenvolvido com a BullrunData API.

Início Rápido (hospedado — recomendado)

O endpoint hospedado em https://bullrundata.com/api/mcp é o caminho mais rápido. Sem instalação, atualizações automáticas, e todos os clientes MCP abaixo o suportam nativamente.

Obtenha uma chave de API gratuita em bullrundata.com — 100 chamadas/dia, sem cartão de crédito.

Claude Code

claude mcp add --transport http bullrundata https://bullrundata.com/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

Cursor

Adicione em ~/.cursor/mcp.json (ou no .cursor/mcp.json local do projeto):

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

VS Code

Adicione em .vscode/mcp.json (workspace) ou no seu mcp.json de usuário:

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

Windsurf

Adicione em ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "bullrundata": {
      "serverUrl": "https://bullrundata.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop

O Claude Desktop ainda não fala HTTP MCP nativamente — faça a ponte via mcp-remote. Adicione em claude_desktop_config.json:

{
  "mcpServers": {
    "bullrundata": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://bullrundata.com/api/mcp",
        "--header",
        "Authorization: Bearer YOUR_API_KEY"
      ]
    }
  }
}

Você também pode pular o header completamente — na primeira conexão, mcp-remote abre um fluxo OAuth no seu navegador e provisiona automaticamente uma chave do plano gratuito.

{
  "mcpServers": {
    "market-intelligence": {
      "command": "npx",
      "args": ["-y", "@bullrundata/market-intelligence"],
      "env": {
        "BULLRUNDATA_API_KEY": "your-api-key"
      }
    }
  }
}

claude mcp add market-intelligence -- npx -y @bullrundata/market-intelligence

Ferramentas Disponíveis

Inteligência Macro

Mercados & Institucional

Calculadoras Imobiliárias

Dados Econômicos

Mecanismo em Cascata (Análise de Cenários Macro)

Catalisadores Disponíveis: Choque de Oferta de Petróleo, Aperto de Liquidez do Dólar, Corte Emergencial de Taxas do Fed, Recessão nos EUA, Escalada China-Taiwan, Inversão da Curva de Juros, Congelamento do Mercado de Crédito, Crise Cambial em Mercados Emergentes, Escalada de Guerra Comercial, Crise de Dívida Soberana

Exemplos de Conversas

"Qual é o risco atual de recessão?"

O Claude usa recession_probability e retorna:

A probabilidade atual de recessão é de 37,9% (risco moderado). Postura do Fed: neutra. Regime de mercado: meio de ciclo. Recomendação: sinais mistos exigem cautela. Comece a rotação defensiva.

"É um bom momento para comprar um imóvel de investimento por $450K?"

O Claude usa investment_property_analysis + interest_rates:

A $450K com entrada de 20% a 7%, o fluxo de caixa mensal é de $287. Cap rate: 5,3%. Retorno sobre o capital investido (cash-on-cash): 4,2%. DSCR: 1,18 (saudável). Taxa atual de hipoteca de 30 anos: 6,38%.

"Qual é o sinal de risk-on/risk-off do mercado?"

O Claude usa sectors_rotation + institutional_cftc:

Sinal de rotação setorial: RISK_ON. Setores cíclicos liderando, defensivos ficando para trás. Posicionamento institucional alinhado à busca de risco. Plano de ação: mantenha sobrepeso em cíclicos, fique atento a quebra da rotação.

"O que acontece se o petróleo chegar a $120?"

O Claude usa cascade_analysis + sectors_rotation:

Cascata do Choque de Oferta de Petróleo: a demanda por dólar dispara (mecânico) -> drenagem das reservas cambiais asiáticas (provável, semanas) -> saídas de ações asiáticas (provável) -> aumentos forçados de juros na Ásia (provável, meses). Rotação setorial atual: RISK_ON, mas o setor de energia ficando para trás sugere que o mercado ainda não precificou o risco de oferta. Plano de ação: proteções contra inflação e reservas de caixa. Acompanhe o uso das linhas de swap do Fed como sinal sistêmico.

Configuração

Para o endpoint hospedado, a autenticação é passada como um header Bearer na configuração do seu cliente (veja Início Rápido acima) ou negociada via OAuth na primeira conexão — nenhuma variável de ambiente é necessária.

Para a instalação local do npx:

Preços

Solução de Problemas

As ferramentas não aparecem no Claude após a instalação

1. Confirme se o servidor MCP está registrado: no Claude Desktop, verifique Settings → Connectors (ou Developer) para market-intelligence. No Claude Code, execute claude mcp list.
2. Reinicie o Claude Desktop completamente (saia, não apenas feche a janela) — alterações de conector não são recarregadas a quente.
3. Verifique se a variável de ambiente BULLRUNDATA_API_KEY está definida e é válida. Sem ela, as ferramentas falham na primeira chamada.
4. Se estiver usando o servidor remoto (https://market.bullrundata.com/mcp) diretamente, conclua o fluxo OAuth no navegador quando solicitado — o Claude precisa do bearer token antes de poder chamar as ferramentas.

401 Unauthorized de uma ferramenta

Sua chave de API está ausente, expirada ou inativa. Obtenha uma nova em bullrundata.com/login. Para o fluxo do servidor remoto, reautentique pela tela de OAuth; o conector provisiona automaticamente uma chave do plano gratuito na primeira conexão.

429 Too Many Requests

Você atingiu seu limite diário de requisições. Os limites são redefinidos às 00:00 UTC.

Faça upgrade em bullrundata.com/pricing ou aguarde a redefinição UTC.

Fluxo OAuth travado ou expirando (servidor remoto)

O servidor remoto usa GitHub OAuth. Se o redirecionamento travar:

1. Confirme se cookies e pop-ups são permitidos para market.bullrundata.com e claude.ai
2. Tente autorizar em uma janela anônima (limpa o estado OAuth em cache)
3. Verifique se https://market.bullrundata.com/.well-known/oauth-authorization-server retorna 200 no seu navegador

A primeira requisição é lenta (~2–4 segundos)

Latência de cold-start na implantação serverless. Requisições subsequentes na mesma sessão devem responder em <500ms.

cascade_analysis retorna "live data unavailable"

A ferramenta de cascata opcionalmente enriquece com dados de mercado ao vivo da BullrunData. Se a API upstream estiver brevemente inacessível, você ainda receberá a árvore completa de catalisadores — apenas a sobreposição ao vivo é ignorada. Passe include_live_data: false para pular a busca ao vivo completamente.

A ferramenta retorna dados desatualizados

Os indicadores econômicos são atualizados várias vezes ao dia. Verifique data_freshness em dashboard_summary para o timestamp da última atualização.

Ainda travado

Abra uma issue em GitHub Issues ou envie um e-mail para support@bullrundata.com com: nome da ferramenta, mensagem de erro completa e um timestamp aproximado.

Suporte

• Site: bullrundata.com
• Documentação: bullrundata.com/docs
• Issues: GitHub Issues

Licença

Elastic License 2.0 — veja LICENSE.

Você pode usar, modificar e redistribuir este software. Você não pode oferecê-lo como um serviço hospedado ou gerenciado que forneça aos usuários acesso a um conjunto substancial dos recursos ou funcionalidades do software.