Newsflash
Five years of corroborated news events, queryable by agents.newsflash.sh watches 260+ outlets across geographies andlanguages and collapses the noise into a deduped event graph — one happening,every source that corroborated it, a confidence score — live to the minute andbackfilled five years deep, so agents can backtest on history and act on thewire. Served over MCP, a CLI, a real-time SSE stream, and a plainHTTP API.
Humans read; agents query. No account needed to start.
# 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 athttps://newsflash.sh/mcp — listed in the official MCP registry assh.newsflash/newsflash. Point any MCP host at it:
// 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 forClaude, 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 andpings you when a story crosses your corroboration threshold.
CLI
A standalone, zero-dependency npm package (./cli, published asnewsflash):
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 sciencehealth energy sports.
OpenAPI
The full REST surface is described in openapi.yaml — anOpenAPI 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. Importit into Pipedream, RapidAPI, Postman, or a custom GPT Action to drive Newsflashfrom 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 RESTand /mcp. Every response carries X-RateLimit-Limit / X-RateLimit-Remaining /X-Newsflash-Tier; limits reset at midnight UTC. Keys are shown once and storedonly as hashes.
How the event graph works
New articles are normalized and matched against recent events using trigramsimilarity — across categories, so a crypto outlet and a tradfi outletreporting the same happening corroborate one event. Above the similaritythreshold → the article attaches to the event and bumps its corroboration;otherwise it seeds a new event. confidence = min(1, distinct_sources / 3) — anevent corroborated by 3+ independent outlets maxes out.
That makes the graph a signal instrument: agents can distinguish asingle-outlet rumor (confidence 0.33) from a story the whole press corps isrunning (confidence 1.0, sources listed), and query the full archive tobacktest on history.
About this repository
This repo holds the open-source (MIT) client surface of Newsflash: thezero-dependency CLI (cli/), the Claude Code plugin manifests(.claude-plugin/), and the MCP registry manifest(server.json). The Newsflash backend is a hosted serviceoperated at newsflash.sh and is not part of thisrepository.
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]
