@gridnews/mcp

MCP server for GridNews — market news, press releases, and sentiment for AI agents.

Gives any MCP-capable assistant the latest market coverage: story clusters ranked by how many independent outlets corroborated them, article search across thousands of sources, per-ticker news with an aggregate sentiment reading, primary-source wire releases, and trending topic clusters.

Install

Requires Node.js 20+ and a GridNews API key. get_topics works without a key; every other tool needs one.

Claude Code

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

Claude Desktop

Add to claude_desktop_config.json:

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

Cursor

Add to .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

Add to ~/.gemini/settings.json:

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

Configuration

Variable	Default	Purpose
GRIDNEWS_API_KEY	—	Your API key. Required for everything except get_topics.
GRIDNEWS_BASE_URL	https://api.gridnews.io	Override the API host.
GRIDNEWS_TIMEOUT_MS	30000	Per-request timeout. Raise it if you use get_symbol_sentiment heavily.

Tools

Tool	Purpose	Minimum tier
get_top_events	The biggest stories now, as clusters ranked by independent corroboration	free (filters need basic)
get_event_detail	Every outlet that carried one story, grouped by independent voice	free
search_news	Search articles and press releases by text, symbol, source, date, sentiment, and quality	free (filters need basic)
get_symbol_news	Recent coverage for one ticker, plus an aggregate sentiment reading	free
get_symbol_sentiment	Sentiment analysis for a ticker over a timeframe, with its basis	pro
list_press_releases	Wire releases filtered by symbol, provider, company, and date	free
list_sources	The sources GridNews indexes, with ids for the sources filter	free
get_topics	Trending topic clusters as keyword groups with article counts	none
get_usage	The key's tier, entitlements, and remaining daily quota	free

Corroboration, not outlet count

get_top_events returns stories rather than documents, and reports two different numbers:

• sourcesCount — how many outlets carried the story. This is reach.
• independent voices — how many of those were not republishing each other. This is the evidence.

They are usually not the same. Outlets that redistribute each other collapse into one voice, so a story on five outlets all running the same wire copy is one voice, not five. Where an outlet was carrying someone else's copy, the tool marks it 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/...

A press release is always a single voice however many wires carried it — one issuer announcing itself is not confirmation.

Pass minVoices: 2 for corroborated stories only. There is no default: single-voice clusters are real distribution records and are not hidden, they just rank last.

Tier behaviour

GridNews gates features and history depth by tier. Rather than failing opaquely, the tools report what a call needs:

• A 403 names the required tier and the key's current one, so the agent can retry without the gated parameter instead of giving up.
• A 429 reports remaining quota and reset time, so the agent waits rather than looping.
• Results note when a tier's history window excluded older articles, so a thin result isn't mistaken for an absence of coverage.

get_usage explains any of these on demand.

Development

npm install
npm run build
npm test

The test suite drives the built server over a real stdio MCP session against a stubbed API, so it covers protocol handshake, argument validation, HTTP serialization, formatting, and the tier/quota failure paths without needing a live key.

License

MIT