lit-forge-mcp

Servidor MCP lit-forge

Simulação de formação de patrimônio pessoal, snapshot dos principais indicadores de mercado, calendário de divulgações econômicas, declarações de autoridades de bancos centrais e eventos geopolíticos — um servidor stdio do Model Context Protocol (MCP) que pode ser chamado diretamente pela IA (19 ferramentas).

Funciona em qualquer cliente compatível com MCP, como Claude Desktop / Claude Code / Cursor.

Destaques da versão mais recente (v0.20.0): Novo adaptador ao vivo do ForexFactory em get_economic_release_pulse. Adicionado o número de vagas de emprego JOLTS dos EUA (não incluído no PFEI, portanto anteriormente perdido) via obtenção dinâmica, e substituída a leitura antecipada do PMI da S&P Global de transcrição manual estática para obtenção ao vivo (eliminando atualização manual semestral). Além disso, adicionados ao pulse, ao vivo: ISM manufatura/não manufatura, confiança do consumidor (CB/Universidade de Michigan) e emprego ADP. Nas datas de divulgação, o calendário semanal XML do faireconomy é obtido em tempo de execução, eliminando a necessidade de adições manuais futuras. A conversão GMT→JST também é precisa para eventos que cruzam a meia-noite. ※ Os três principais indicadores do BLS (relatório de emprego, CPI e PPI) permanecem com o PFEI como fonte primária oficial.

v0.19.0: Adicionado em get_economic_release_pulse o Relatório de Indicadores Econômicos Antecipados do U.S. Census Bureau (valores antecipados de estoques no atacado, estoques no varejo e balança comercial de bens, mensal às 08:30 ET), eliminando a lacuna de cobertura de itens como "estoques no atacado dos EUA [valor antecipado]" que nenhum adaptador capturava anteriormente. Nas datas de divulgação, o calendário oficial (List View) é obtido ao vivo em tempo de execução, acompanhando as atualizações da página oficial mesmo para anos seguintes (sem atualização manual).

v0.18.0: Nova ferramenta get_central_bank_speakers adicionada. Obtém ao vivo, do calendário gratuito do ForexFactory, as próximas declarações e discursos de autoridades de bancos centrais (diretores do Fed, presidentes dos distritos do Fed, BoJ, BCE, BoE etc.), complementando para o Fed dos EUA o cargo (ex.: presidente do Dallas Fed) e se possui direito a voto com base na lista do FOMC do ano corrente. Declarações de membros com direito a voto têm importância elevada (presidente=★★★ / membros com voto=★★ ou mais). ※ A categoria estática centralbank introduzida temporariamente em get_economic_events_today na v0.17.0 foi consolidada nesta ferramenta (removida).

v0.16.0: Adicionados ao get_economic_events_today (calendário econômico de curadoria manual) o Índice de Confiança do Consumidor dos EUA (Conference Board, última terça-feira do mês) e o Índice de Sentimento do Consumidor da Universidade de Michigan (leitura preliminar=2ª sexta-feira / leitura final=4ª sexta-feira). Cobre os indicadores de sentimento do consumidor dos EUA, de alta relevância para o câmbio.

v0.15.0: Adicionados ao get_economic_release_pulse os pedidos semanais de seguro-desemprego do DOL/ETA (semanal, toda quinta-feira às 08:30 ET) e a leitura antecipada do PMI dos EUA da S&P Global (flash de manufatura/serviços, 09:45 ET), eliminando lacunas de cobertura que existiam anteriormente.

v0.14.0: Integrado o cronograma PFEI (Principal Federal Economic Indicators) do OMB/OIRA da Casa Branca, permitindo a obtenção automática das datas de divulgação dos três principais indicadores do BLS (relatório de emprego, CPI e PPI). Também expandido o get_us_macro_latest de 4 para 7 séries (adicionados núcleo do CPI, núcleo do PPI e salário médio por hora).

Em conversas com Claude / GPT / Cursor, você pode obter respostas em um único turno para perguntas como:

• "Meu dinheiro para a aposentadoria é suficiente?" "Quanto devo investir por mês para chegar a 20 milhões de ienes?"
• "Resuma o mercado de hoje com 28 indicadores" "Quais setores estão mais fortes?"
• "Quando é o próximo relatório de emprego?" "Resuma as divulgações do Fed deste mês"
• "Quais são os valores mais recentes do CPI e PPI em relação ao mesmo mês do ano anterior?" "Compare o núcleo do CPI com o núcleo do PPI"
• "Quando é a cúpula do G7 deste mês?" "Quais são as manchetes atuais sobre a situação no Irã?"

Ferramentas fornecidas (18 tipos)

Planejador de formação de patrimônio pessoal (funções puras, sem API externa) — 4 ferramentas

Conjunto de simulações de juros compostos mensais para tsumitate NISA / iDeCo / planejamento de aposentadoria.

Nome da ferramenta	Descrição
simulate_nisa	Calcula valor estimado, ganhos de investimento e evolução anual com juros compostos mensais a partir do valor mensal investido, taxa de juros anual presumida e número de anos
plan_retirement	Diagnostica a suficiência dos fundos de aposentadoria em 3 cenários (otimista/realista/pessimista) com base em idade, poupança, renda, custo de vida desejado, tolerância a risco e pensão + calcula o valor mensal necessário
calculate_required_monthly	Calcula o valor mensal necessário para atingir a meta, com base no valor alvo, poupança atual, taxa de juros anual e número de anos
calculate_compound_interest	Ferramenta genérica de cálculo de juros compostos que avalia principal (montante único) e investimento mensal com juros compostos mensais

Snapshot de mercado e ações individuais — 2 ferramentas

Nome da ferramenta	Descrição
get_market_snapshot	Obtém de uma só vez os principais 28 indicadores: USD/JPY, EUR/JPY, GBP/JPY, AUD/JPY, EUR/USD, CHF/JPY, índice do dólar, Nikkei 225, TOPIX, Dow Jones, S&P 500, NASDAQ, VIX, NYSE FANG+, SOX, DAX, FTSE, Xangai Composto, Hang Seng, KOSPI, SENSEX, títulos de 10/5 anos dos EUA, ouro, petróleo, cobre, bitcoin, ethereum
get_quote	Obtém valor atual e variação diária de qualquer ticker do Yahoo Finance (ações, câmbio, índices, commodities, criptoativos). Exemplos: AAPL / ^DJI / BTC-USD. Com includeFundamentals: true, também obtém PER / PBR / rendimento de dividendos / beta / capitalização de mercado

Visão geral do mercado — 5 ferramentas

Nome da ferramenta	Descrição
get_market_thermometer	Pontuação de risco on/off de 0 a 100 combinando VIX, S&P 500, taxa de 10 anos dos EUA e índice do dólar + evolução dos últimos 30 dias úteis
get_performance_ranking	Ordena 28 ativos pelo desempenho de 1d/1w/1m, retornando os N primeiros/últimos
get_yield_spread	Spread de rendimento de 10 anos - 5 anos dos EUA (positivo=curva normal / negativo=curva invertida)
get_market_sessions	Status atual do horário de negociação dos 4 principais mercados (Tóquio, Xangai, Londres, NY) (open / pre-open / closed / holiday, com suporte a feriados)
get_sector_heatmap	Lista de variação diária dos ETFs setoriais de ações dos EUA (SPDR, 11 setores)

Análise aprofundada de ações individuais — 2 ferramentas

Nome da ferramenta	Descrição
get_dividend_history	Obtém histórico de dividendos dos últimos N anos e total por ano civil de ações individuais e ETFs (years: 1/3/5/10, padrão 5). Usado como fonte primária para considerar ações com dividendos no quadro de crescimento do NISA
get_analyst_consensus	Obtém classificação de recomendação de analistas (compra forte a venda forte), preço-alvo (média/máxima/mínima) e detalhamento mensal das recomendações de ações individuais. A cobertura é ampla para ações dos EUA; ações da TSE e ETFs tendem a ter dados ausentes

Eventos econômicos, declarações de autoridades de bancos centrais e valores macro mais recentes — 4 ferramentas

Dividem as funções de "quando será divulgado" (2 de calendário), "quem fala e quando" (1 de declarações) e "qual é o número atual" (1 de valores mais recentes).

Nome da ferramenta	Descrição
get_economic_events_today	Retorna eventos econômicos do dia ou da semana (FOMC, reunião de política monetária do BoJ, relatório de emprego dos EUA, CPI, PIB, Índice de Confiança do Consumidor dos EUA (CB / Universidade de Michigan), PMI da China etc.) com nível de importância. Com category, é possível filtrar por macro / geopolitical / policy. Eventos de período (como a reunião de Jackson Hole) são suportados para vários dias com endDate. Curadoria manual para seis meses. Para declarações de autoridades de bancos centrais, use get_central_bank_speakers
get_central_bank_speakers	Obtém ao vivo as próximas declarações e discursos de autoridades de bancos centrais: extrai eventos de declarações do calendário gratuito do ForexFactory (diretores do Fed, presidentes dos distritos do Fed, BoJ, BCE, BoE etc.). Para o Fed dos EUA, complementa role (ex.: presidente do Dallas Fed) / votingMember (se possui direito a voto) com base na lista do FOMC do ano corrente, elevando a importância de membros com direito a voto (presidente=★★★ / membros com voto=★★ ou mais). Filtros por range (today/week) e countries (US/JP/EU/GB/CN/OTHER). Cache de 6 horas
get_economic_release_pulse	Obtém efetivamente as divulgações oficiais: obtém em paralelo os calendários do BEA / NY Fed / Fed / BLS (via PFEI) / DOL/ETA (pedidos semanais de seguro-desemprego) / ForexFactory ao vivo (vagas JOLTS, PMI antecipado de manufatura/serviços, ISM manufatura/não manufatura, confiança do consumidor [CB/Universidade de Michigan], emprego ADP) / Census Bureau (antecipados de estoques no atacado, estoques no varejo e balança comercial de bens) / Gabinete do Governo / BoJ, retornando de forma integrada as divulgações de indicadores econômicos de hoje, desta semana e deste mês. Os três principais indicadores do BLS foram integrados ao cronograma PFEI na v0.14.0, os Indicadores Econômicos Antecipados do Census Bureau foram adicionados na v0.19.0, e o adaptador ao vivo do ForexFactory foi criado na v0.20.0 (adição de JOLTS, PMI antecipado da S&P ao vivo, e adição de ISM/confiança do consumidor/ADP)
get_us_macro_latest	Valores mais recentes das 7 séries macro dos EUA: obtém relatório de emprego, taxa de desemprego, CPI, núcleo do CPI, PPI, núcleo do PPI e salário médio por hora em uma única requisição à BLS Public Data API v2. Retorna valor + variação mensal + variação anual. Sem necessidade de chave de API, 25 requisições diárias sem autenticação, cache de 6 horas

Geopolítica — 2 ferramentas

Dois fluxos: cronograma confirmado (calendário) e notícias em tempo real (pulse).

Nome da ferramenta	Descrição
get_geopolitical_calendar	Cronograma oficial confirmado: retorna eventos geopolíticos de hoje, desta semana e deste mês em 4 subcategorias (summit / bilateral / election / risk). Com marketImplications / participants / sourceUrl. Dados estáticos atualizados manualmente via PR uma vez por semestre
get_geopolitical_pulse	Notícias em tempo real: obtém em paralelo os RSS da BBC World, Al Jazeera e Google News (busca por tópico), retornando eventos geopolíticos em andamento (cúpulas, conflitos, sanções, cenários de bloqueio etc.) em ordem cronológica. topic: us-china / middle-east / ukraine / japan / global. Apenas metadados dos artigos (título, fonte, data/hora de publicação, URL); a interpretação é responsabilidade do LLM chamador

Sobre comunicação HTTP

As ferramentas de mercado, análise e ações individuais enviam requisições HTTPS para a API do Yahoo Finance (query1.finance.yahoo.com / query2.finance.yahoo.com), get_us_macro_latest para a BLS Public Data API v2 (api.bls.gov), get_economic_release_pulse para as páginas de calendário das instituições oficiais, get_geopolitical_pulse para os RSS da BBC / Al Jazeera / Google News, e get_central_bank_speakers para o calendário gratuito do ForexFactory (nfs.faireconomy.media). Observe que haverá comunicação externa saindo da rede do computador onde a ferramenta é executada.

Os dados são valores de referência com atraso de dezenas de minutos a 1 hora, fornecidos como agregação de informações, não como aconselhamento de investimento.

Os fundamentals de get_quote / get_dividend_history / get_analyst_consensus passam pelo Yahoo Finance v10 quoteSummary (com autenticação via crumb), portanto utilizam yahoo-finance2 como pacote dependente.

Instalação / Configuração

Para Claude Desktop

Adicione o seguinte ao claude_desktop_config.json.

{
  "mcpServers": {
    "lit-forge": {
      "command": "npx",
      "args": ["-y", "lit-forge-mcp@latest"]
    }
  }
}

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

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

Para Claude Code

claude mcp add lit-forge -- npx -y lit-forge-mcp@latest

Para Cursor

Adicione o mesmo JSON ao ~/.cursor/mcp.json (ou ao .cursor/mcp.json na raiz do projeto).

💡 Sobre a especificação de @latest

Todos os exemplos de configuração acima especificam lit-forge-mcp@latest. Isso ocorre porque, devido ao comportamento de cache do npx, sem especificar a versão, uma versão antiga em cache pode continuar sendo usada. Ao especificar @latest, a versão mais recente do registro npm é verificada e obtida a cada inicialização (o overhead de resolução de versão é mínimo).

Se você já opera com lit-forge-mcp (sem especificação de versão), tente uma das seguintes opções para incorporar novos recursos e correções de bugs:

1. Altere a configuração para lit-forge-mcp@latest (solução permanente, recomendada)
2. Limpe o cache do npx: npx clear-npx-cache ou exclua manualmente ~/.npm/_npx/
3. Encerre completamente e reinicie o cliente MCP (como o Claude Desktop)

Desenvolvimento local

git clone https://github.com/noblabs/lit-forge-mcp.git
cd lit-forge-mcp
npm install
npm run build
node dist/index.js   # stdio で起動

Verificação de funcionamento

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"smoke","version":"0.0.1"}}}
{"jsonrpc":"2.0","method":"notifications/initialized"}
{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | node dist/index.js

Se 18 ferramentas aparecerem na resposta de tools/list, o funcionamento está correto.

Exemplos de uso

Você pode fazer solicitações como estas ao Claude:

Planejamento de formação de patrimônio

• "Tenho 35 anos e invisto 30 mil ienes por mês. Poupança atual de 5 milhões, aposentadoria aos 65, custo de vida mensal desejado de 250 mil ienes. Meu dinheiro para a aposentadoria é suficiente?"
• "Quero acumular 20 milhões em 20 anos. Tenho 5 milhões agora e taxa anual de 4%. Quanto devo investir por mês?"
• "Quanto rendem 1 milhão de ienes a 5% ao ano com juros compostos por 30 anos?"
• "Se eu investir 30 mil ienes por mês a 6% ao ano por 20 anos?"

Snapshot de mercado

• "Resuma o mercado de hoje" "Mostre a variação diária dos principais indicadores em uma tabela"
• "Comente o nível de risco atual com base no movimento da taxa de 10 anos dos EUA e do Nikkei"
• "Qual é o valor atual do BTC-USD?" "Me informe a libra/iene (GBPJPY=X)"

Análise aprofundada de ações individuais

• "Mostre o histórico de dividendos da KO nos últimos 10 anos" "Qual é o total anual de dividendos do VYM?"
• "Qual é o preço-alvo dos analistas e a classificação de recomendação da NVDA?"
• "Resuma PER / PBR / rendimento de dividendos / beta da AAPL" (com get_quote e includeFundamentals=true)

Calendário de indicadores econômicos e valores mais recentes

• "Quais são os eventos econômicos desta semana? Especialmente FOMC e BoJ"
• "Quando é o próximo relatório de emprego?" "Resuma as divulgações do Fed e do Gabinete do Governo deste mês"
• "CPI e PPI mais recentes, com variação mensal e anual" "Compare o núcleo do CPI com o núcleo do PPI"

Declarações de autoridades de bancos centrais

• "Quais são as declarações do Fed hoje? Só as de quem tem direito a voto" "Lista de palestrantes de bancos centrais desta semana" (get_central_bank_speakers)
• "Há declarações previstas da presidente do BCE Lagarde ou do BoJ esta semana?" (filtrar com countries=["EU","JP"])

Eventos geopolíticos

• "Quais são os eventos geopolíticos desta semana?" "Qual é a programação da cúpula do G7 deste mês?"
• "Quando é a próxima cúpula EUA-China?" "Extraia apenas as cúpulas relacionadas ao Japão" (filtrar com country=["JP"])
• "Quais são as manchetes atuais sobre a situação no Irã?" "Quais são as últimas notícias sobre a paz na Ucrânia?"

Aviso de decisão de investimento

Todos os cálculos desta ferramenta são valores de referência baseados em juros compostos mensais. Não garantem resultados reais de investimento (flutuações de mercado, impostos, taxas, câmbio). Não se trata de recomendação de produtos financeiros específicos; as decisões de investimento são de sua própria responsabilidade.

A estimativa do valor da pensão pública é baseada nos valores padrão do seguro de pensão dos funcionários (kosei nenkin). Para valores precisos, consulte o nenkin net.

Licença

MIT