GridNews

Notícias de mercado, comunicados à imprensa e sentimento de tickers para agentes de IA via REST, streams e MCP.

Documentação

@gridnews/mcp

Servidor MCP para GridNews — notícias de mercado, comunicados à imprensa e análise de sentimento para agentes de IA.

Oferece a qualquer assistente compatível com MCP a cobertura de mercado mais recente: clusters de histórias classificados por quantos veículos independentes os corroboraram, busca de artigos em milhares de fontes, notícias por ticker com leitura agregada de sentimento, comunicados de fontes primárias e clusters de tópicos em alta. Com uma chave Pro, também pode executar pesquisa Grid AI: ler documentos ou resultados de busca e retornar trechos verbatim com citações, além de uma comparação opcional entre eles.

Instalação

Requer Node.js 20+ e uma chave de API da GridNews. get_topics funciona sem chave; todas as outras ferramentas precisam de uma.

Claude Code

claude mcp add gridnews --env GRIDNEWS_API_KEY=your_key -- npx -y @gridnews/mcp

Claude Desktop

Adicione em claude_desktop_config.json:

{
  "mcpServers": {
    "gridnews": {
      "command": "npx",
      "args": ["-y", "@gridnews/mcp"],
      "env": { "GRIDNEWS_API_KEY": "your_key" }
    }
  }
}

Cursor

Adicione em .cursor/mcp.json:

{
  "mcpServers": {
    "gridnews": {
      "command": "npx",
      "args": ["-y", "@gridnews/mcp"],
      "env": { "GRIDNEWS_API_KEY": "your_key" }
    }
  }
}

OpenAI Codex

codex mcp add gridnews --env GRIDNEWS_API_KEY=your_key -- npx -y @gridnews/mcp

Gemini CLI

Adicione em ~/.gemini/settings.json:

{
  "mcpServers": {
    "gridnews": {
      "command": "npx",
      "args": ["-y", "@gridnews/mcp"],
      "env": { "GRIDNEWS_API_KEY": "your_key" }
    }
  }
}

Configuração

Variável	Padrão	Finalidade
`GRIDNEWS_API_KEY`	—	Sua chave de API. Necessária para tudo, exceto `get_topics`.
`GRIDNEWS_BASE_URL`	`https://api.gridnews.io`	Substitui o host da API.
`GRIDNEWS_TIMEOUT_MS`	`30000`	Tempo limite por requisição. Aumente se usar `get_symbol_sentiment` com frequência.
`GRIDNEWS_WS_URL`	`wss://stream.gridnews.io`	Substitui o host de streaming ao qual `research` e `get_research` se conectam.

Ferramentas

Ferramenta	Finalidade	Nível mínimo
`get_top_events`	As maiores histórias do momento, como clusters classificados por corroboração independente	gratuito (filtros exigem básico)
`get_event_detail`	Todos os veículos que publicaram uma história, agrupados por voz independente	gratuito
`search_news`	Busca artigos e comunicados por texto, símbolo, fonte, data, sentimento e qualidade	gratuito (filtros exigem básico)
`get_symbol_news`	Cobertura recente de um ticker, com leitura agregada de sentimento	gratuito
`get_symbol_sentiment`	Análise de sentimento de um ticker em um período, com sua base	pro
`list_press_releases`	Comunicados filtrados por símbolo, provedor, empresa e data	gratuito
`list_sources`	As fontes indexadas pela GridNews, com ids para o filtro `sources`	gratuito
`get_topics`	Clusters de tópicos em alta como grupos de palavras-chave com contagens de artigos	nenhum
`get_usage`	O nível da chave, direitos e cota diária restante	gratuito
`research`	Lê documentos ou resultados de busca e retorna trechos citados; `deep` também os compara	pro
`get_research`	Coleta uma solicitação de pesquisa que ainda estava em execução quando `research` retornou	pro

Corroboração, não contagem de veículos

get_top_events retorna histórias em vez de documentos e informa dois números diferentes:

sourcesCount — quantos veículos publicaram a história. Isso é alcance.
independent voices — quantos desses não estavam republicando uns aos outros. Isso é a evidência.

Geralmente não são iguais. Veículos que redistribuem conteúdo uns dos outros se colapsam em uma única voz, então uma história em cinco veículos que publicam o mesmo texto de agência é uma voz, não cinco. Quando um veículo estava publicando cópia de outro, a ferramenta marca isso inline:

2 independent voices across 4 outlets · 4 filings · impact 1.47
- Wall Street Journal: https://wsj.com/...
- Dow Jones [carrying wall-street-journal]: https://morningstar.com/...
- GuruFocus: https://gurufocus.com/...

Um comunicado à imprensa é sempre uma única voz, independentemente de quantas agências o veicularam — um emissor se anunciando não é confirmação.

Passe minVoices: 2 para apenas histórias corroboradas. Não há padrão: clusters de voz única são registros reais de distribuição e não ficam ocultos, apenas ficam em último lugar na classificação.

Pesquisa Grid AI

research lê até 8 documentos que você nomeia (urls), ou busca na web ou em notícias e lê os resultados, e retorna as passagens relevantes à consulta, citadas verbatim e numeradas para citação. depth: "deep" vai além: compara as fontes e responde até 3 questions, marcando quais afirmações são das fontes e quais são inferência, e nomeando lacunas e divergências. Uma solicitação profunda precisa de pelo menos 3 fontes, ou 2 URLs diferentes; abaixo disso seria um documento parafraseado, o que não é análise.

# Grid AI research: Why was the export rule extended?
id sdk-4f1c... · deep · complete · 4 of 4 sources read · 38.2s

## Sources
[1] Commerce extends chip export rule
    reuters.com · 3h ago (2026-09-29T09:12:00Z, page date)
    https://reuters.com/...
    > The department said the extension gives ...

## Analysis: Why was the export rule extended?
Findings:
- Both reports tie the extension to the licensing review. [1][3]
- (inference) The timing suggests ... [2]

Uma solicitação rápida leva até 90 segundos e uma profunda até 4 minutos. Muitos clientes MCP desistem de uma chamada de ferramenta após cerca de um minuto, então research espera waitSeconds (padrão 50) e então retorna o que chegou com o id da solicitação. A solicitação continua em execução, e get_research a coleta. Os resultados são mantidos por uma hora. Clientes que pedem progresso recebem uma notificação por fonte, o que permite que aqueles que reiniciam o tempo limite com o progresso esperem pela solicitação inteira.

A pesquisa roda sobre o WebSocket do stream da GridNews e usa uma das conexões de stream da chave enquanto executa. Cada chave pode executar 2 solicitações por vez no Pro e 4 no Business, e a pesquisa conta contra a cota de Grid AI da chave.

Comportamento por nível

A GridNews limita recursos e profundidade de histórico por nível. Em vez de falhar de forma opaca, as ferramentas informam o que uma chamada precisa:

Um 403 nomeia o nível exigido e o atual da chave, para que o agente possa tentar novamente sem o parâmetro limitado em vez de desistir.
Um 429 informa a cota restante e o tempo de redefinição, para que o agente espere em vez de repetir em loop.
Os resultados observam quando a janela de histórico de um nível excluiu artigos mais antigos, para que um resultado enxuto não seja confundido com ausência de cobertura.

get_usage explica qualquer um desses sob demanda.

Desenvolvimento

npm install
npm run build
npm test

A suíte de testes conduz o servidor compilado em uma sessão MCP stdio real contra uma API simulada, então cobre handshake de protocolo, validação de argumentos, serialização HTTP, formatação e os caminhos de falha de nível/cota sem precisar de uma chave ativa.

Licença

MIT