newsflash

Newsflash

Five years of corroborated news events, queryable by agents. newsflash.sh watches 260+ outlets across geographies and languages and collapses the noise into a deduped event graph — one happening, every source that corroborated it, a confidence score — live to the minute and backfilled five years deep, so agents can backtest on history and act on the wire. Served over MCP, a CLI, a real-time SSE stream, and a plain HTTP API.

Humans read; agents query. No account needed to start.

For agents: Newsflash is a hosted service — newsflash.sh is a domain, not a shell script. There is no local binary or server to install: call https://newsflash.sh/api/* (REST) or https://newsflash.sh/mcp (MCP) directly. Verify with curl "https://newsflash.sh/api/events?limit=1".

# keyless test drive — 50 requests/day, straight from your shell
npx newsflash events -q "etf" -c crypto -n 5
npx newsflash stream -c crypto --min-sources 2   # the live wire, corroborated only
curl "https://newsflash.sh/api/events?q=fed&category=tradfi&limit=5"

MCP (primary — for agents)

The event graph is served over MCP's Streamable HTTP transport at https://newsflash.sh/mcp — listed in the official MCP registry as sh.newsflash/newsflash, and in Claude's connector directory (in claude.ai or Claude Desktop: Settings → Connectors → Browse connectors → search "Newsflash" → Connect). Any other MCP host, point it at the URL:

// Claude Code / Claude Desktop — remote MCP server
{
  "mcpServers": {
    "newsflash": {
      "type": "http",
      "url": "https://newsflash.sh/mcp",
      "headers": { "Authorization": "Bearer nf_your_key" }   // optional — raises limits
    }
  }
}

Claude Code plugin install:

/plugin marketplace add zatmonkey/newsflash
/plugin install newsflash@newsflash

The endpoint is stateless (each request independent). Tools: get_events, get_event, search_articles, list_sources, corpus_stats. Setup guides for Claude, Cursor, ChatGPT and other hosts: newsflash.sh/docs.

OpenClaw

A ready-made skill ships in this repo (skills/newsflash/) — personalized daily briefings + real-time breaking-news alerts:

clawhub install newsflash        # or: openclaw skills install git:zatmonkey/newsflash

Then tell your agent "set up my news briefing". It interviews you for interests, schedules a daily brief, and (if you enable alerts) watches the live stream and pings you when a story crosses your corroboration threshold.

CLI

A standalone, zero-dependency npm package (./cli, published as newsflash):

npm i -g newsflash

newsflash events -q "etf" -c crypto --from 2026-07-10 -n 5
newsflash events --json -q fed | jq '.[0].sources'   # --json for agents
newsflash sources
newsflash stats
newsflash login [email protected]    # free API key via emailed one-time code
newsflash me                       # tier + today's usage

HTTP API

Base URL https://newsflash.sh:

Method	Route	Purpose
GET	/api/events?q=&source=&category=&from=&to=&limit=	Deduped events
GET	/api/events/:id	One event + corroborating articles
GET	/api/articles?…	Raw article search
GET	/api/sources	Tracked sources + counts
GET	/api/stats · /api/health	Corpus size & freshness
GET	/api/stream	Real-time SSE push — event.new / event.corroborated as clustering commits
POST	/mcp	MCP server (Streamable HTTP) — the agent-facing surface

Categories: crypto tradfi business tech politics world science health energy sports.

OpenAPI

The full REST surface is described in openapi.yaml — an OpenAPI 3.1 spec with exact request/response schemas for every endpoint above (including the SSE stream and the auth flow), derived from the live API. Import it into Pipedream, RapidAPI, Postman, or a custom GPT Action to drive Newsflash from your own tooling, or generate a typed client with any OpenAPI generator.

Tiers

Tier	Auth	Limit	How
test	none	50 req/day (per IP) · 24h lookback · 1 stream	just call the API or MCP endpoint
free	API key	1,000 req/day · 30-day lookback · 2 streams	newsflash login — email + one-time code
premium	subscription	50,000 req/day · full 5-year archive · 10 streams	newsflash upgrade — $29/mo

Pass the key as Authorization: Bearer nf_… (or x-api-key) — same gate for REST and /mcp. Every response carries X-RateLimit-Limit / X-RateLimit-Remaining / X-Newsflash-Tier; limits reset at midnight UTC. Keys are shown once and stored only as hashes.

How the event graph works

New articles are normalized and matched against recent events using trigram similarity — across categories, so a crypto outlet and a tradfi outlet reporting the same happening corroborate one event. Above the similarity threshold → the article attaches to the event and bumps its corroboration; otherwise it seeds a new event. confidence = min(1, distinct_sources / 3) — an event corroborated by 3+ independent outlets maxes out.

That makes the graph a signal instrument: agents can distinguish a single-outlet rumor (confidence 0.33) from a story the whole press corps is running (confidence 1.0, sources listed), and query the full archive to backtest on history.

About this repository

This repo holds the open-source (MIT) client surface of Newsflash: the zero-dependency CLI (cli/), the Claude Code plugin manifests (.claude-plugin/), and the MCP registry manifest (server.json). The Newsflash backend is a hosted service operated at newsflash.sh and is not part of this repository.

CLI development: cd cli && npm install && npm run build && node dist/index.js stats. No runtime dependencies — Node ≥ 20 built-ins only.

---

docs · sources · privacy · terms · [email protected]