@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

Tools

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