GridNews

Noticias de mercado, comunicados de prensa y sentimiento de tickers para agentes de IA a través de REST, streams y MCP.

Documentación

@gridnews/mcp

Servidor MCP para GridNews: noticias de mercado, comunicados de prensa y análisis de sentimiento para agentes de IA.

Proporciona a cualquier asistente compatible con MCP la cobertura de mercado más reciente: grupos de historias clasificados por cuántos medios independientes los corroboraron, búsqueda de artículos en miles de fuentes, noticias por ticker con una lectura agregada de sentimiento, comunicados de fuentes primarias y grupos de temas en tendencia. Con una clave Pro, también puede ejecutar investigación Grid AI: leer documentos o resultados de búsqueda y devolver extractos textuales citados, con una comparación opcional entre ellos.

Instalación

Requiere Node.js 20+ y una clave de API de GridNews. get_topics funciona sin clave; todas las demás herramientas la necesitan.

Claude Code

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

Claude Desktop

Agregar a claude_desktop_config.json:

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

Cursor

Agregar a .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

Agregar a ~/.gemini/settings.json:

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

Configuración

Variable	Predeterminado	Propósito
`GRIDNEWS_API_KEY`	—	Tu clave de API. Requerida para todo excepto `get_topics`.
`GRIDNEWS_BASE_URL`	`https://api.gridnews.io`	Sobrescribir el host de la API.
`GRIDNEWS_TIMEOUT_MS`	`30000`	Tiempo de espera por solicitud. Auméntalo si usas `get_symbol_sentiment` con frecuencia.
`GRIDNEWS_WS_URL`	`wss://stream.gridnews.io`	Sobrescribir el host de transmisión al que se conectan `research` y `get_research`.

Herramientas

Herramienta	Propósito	Nivel mínimo
`get_top_events`	Las historias más importantes ahora, como grupos clasificados por corroboración independiente	gratis (los filtros requieren básico)
`get_event_detail`	Cada medio que cubrió una historia, agrupado por voz independiente	gratis
`search_news`	Buscar artículos y comunicados de prensa por texto, símbolo, fuente, fecha, sentimiento y calidad	gratis (los filtros requieren básico)
`get_symbol_news`	Cobertura reciente para un ticker, más una lectura agregada de sentimiento	gratis
`get_symbol_sentiment`	Análisis de sentimiento para un ticker en un período de tiempo, con su base	pro
`list_press_releases`	Comunicados filtrados por símbolo, proveedor, empresa y fecha	gratis
`list_sources`	Las fuentes que GridNews indexa, con ids para el filtro `sources`	gratis
`get_topics`	Grupos de temas en tendencia como grupos de palabras clave con recuentos de artículos	ninguno
`get_usage`	El nivel de la clave, los derechos y la cuota diaria restante	gratis
`research`	Leer documentos o resultados de búsqueda y devolver extractos citados; `deep` también los compara	pro
`get_research`	Recopilar una solicitud de investigación que aún se estaba ejecutando cuando `research` regresó	pro

Corroboración, no recuento de medios

get_top_events devuelve historias en lugar de documentos e informa dos números diferentes:

sourcesCount — cuántos medios cubrieron la historia. Esto es alcance.
independent voices — cuántos de esos no se estaban republicando entre sí. Esto es la evidencia.

Por lo general, no son lo mismo. Los medios que se redistribuyen entre sí se colapsan en una sola voz, por lo que una historia en cinco medios que ejecutan la misma copia de cable es una voz, no cinco. Cuando un medio estaba publicando la copia de otro, la herramienta lo marca en línea:

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/...

Un comunicado de prensa es siempre una sola voz, sin importar cuántos cables lo hayan llevado: un emisor que se anuncia a sí mismo no es confirmación.

Pasa minVoices: 2 solo para historias corroboradas. No hay valor predeterminado: los grupos de una sola voz son registros de distribución reales y no están ocultos, solo se clasifican al final.

Investigación Grid AI

research lee hasta 8 documentos que nombres (urls), o busca en la web o noticias y lee los resultados, y devuelve los pasajes que se relacionan con la consulta, citados textualmente y numerados para la cita. depth: "deep" va más allá: compara las fuentes y responde hasta 3 questions, marcando qué afirmaciones son de las fuentes y cuáles son inferencia, y nombrando vacíos y desacuerdos. Una solicitud profunda necesita al menos 3 fuentes, o 2 URL diferentes; por debajo de eso sería un documento parafraseado, que no es análisis.

# 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]

Una solicitud rápida tarda hasta 90 segundos y una profunda hasta 4 minutos. Muchos clientes MCP abandonan una llamada de herramienta después de aproximadamente un minuto, por lo que research espera waitSeconds (predeterminado 50) y luego devuelve lo que ha llegado con el id de la solicitud. La solicitud continúa ejecutándose y get_research la recopila. Los resultados se conservan durante una hora. Los clientes que solicitan progreso reciben una notificación por fuente, lo que permite que aquellos que restablecen su tiempo de espera en el progreso esperen toda la solicitud.

La investigación se ejecuta a través del WebSocket de transmisión de GridNews y utiliza una de las conexiones de transmisión de la clave mientras se ejecuta. Cada clave puede ejecutar 2 solicitudes a la vez en Pro y 4 en Business, y la investigación cuenta contra la asignación de Grid AI de la clave.

Comportamiento por nivel

GridNews limita las funciones y la profundidad del historial por nivel. En lugar de fallar de manera opaca, las herramientas informan lo que necesita una llamada:

Un 403 nombra el nivel requerido y el actual de la clave, para que el agente pueda reintentar sin el parámetro restringido en lugar de rendirse.
Un 429 informa la cuota restante y el tiempo de reinicio, para que el agente espere en lugar de hacer un bucle.
Los resultados notan cuando la ventana de historial de un nivel excluyó artículos más antiguos, para que un resultado escaso no se confunda con una ausencia de cobertura.

get_usage explica cualquiera de estos bajo demanda.

Desarrollo

npm install
npm run build
npm test

El conjunto de pruebas impulsa el servidor compilado a través de una sesión MCP stdio real contra una API simulada, por lo que cubre el protocolo de enlace, la validación de argumentos, la serialización HTTP, el formato y las rutas de falla de nivel/cuota sin necesidad de una clave en vivo.

Licencia

MIT