@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" }
    }
  }
}

Related MCP server: crypto-news-mcp

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