Real-time corroborated news events + 5-year archive, for agents. Free tier, no key.
sh.newsflash/newsflash (MCP) Server
sh.newsflash/newsflash provides real-time, corroborated news events plus a five-year archive, queryable by agents. It watches 260+ outlets across geographies and languages, dedupes events into a single event graph, and associates each happening with the sources that corroborated it and a confidence score, updated live to the minute.
🛠️ Key Features
Real-time corroborated news events
Five-year archive for agent queries
260+ news outlets across geographies and languages
Deduped event graph per happening
Confidence score and corroborating sources
🚀 Use Cases
Agent workflows that need corroborated news updates
Historical reference using the five-year archive
Reducing duplicate headlines into single events
⚡ Developer Benefits
Structured event graph with confidence scoring
Corroboration data (which outlets agreed) attached to events
Defined tool surface for integration (5 tools)
⚠️ Limitations
Free tier availability and “no key” are indicated, but no further constraints are described in the provided data
Captured live from the server via tools/list.
get_events
Query the deduped news event graph by theme, source, category and time window. Returns events (many articles about one happening collapsed into one), each with a corroboration count and confidence score. This is the primary tool — prefer it over raw articles. The corpus spans 260+ global outlets and a five-year archive (history visible depends on tier).
Parameters7
q
string
optional
Free-text theme/keyword to match on headline + summary
semantic
boolean
optional
Rank by meaning (embedding similarity) instead of keyword match — requires q; better for concepts ('monetary easing') than exact strings
source
string
optional
Source slug, e.g. 'coindesk' (see list_sources)
category
string
optional
Source category
from
string
optional
Only events active on/after this date. ISO 8601 date/time, e.g. 2026-07-01 or 2026-07-01T00:00:00Z
to
string
optional
Only events active on/before this date. ISO 8601 date/time, e.g. 2026-07-01 or 2026-07-01T00:00:00Z
limit
integer
optional
Max events (default 25)
Raw schema
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Free-text theme/keyword to match on headline + summary"
},
"semantic": {
"type": "boolean",
"description": "Rank by meaning (embedding similarity) instead of keyword match — requires q; better for concepts ('monetary easing') than exact strings"
},
"source": {
"type": "string",
"description": "Source slug, e.g. 'coindesk' (see list_sources)"
},
"category": {
"type": "string",
"enum": [
"crypto",
"tradfi",
"business",
"tech",
"politics",
"world",
"science",
"health",
"energy",
"sports"
],
"description": "Source category"
},
"from": {
"type": "string",
"description": "Only events active on/after this date. ISO 8601 date/time, e.g. 2026-07-01 or 2026-07-01T00:00:00Z"
},
"to": {
"type": "string",
"description": "Only events active on/before this date. ISO 8601 date/time, e.g. 2026-07-01 or 2026-07-01T00:00:00Z"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Max events (default 25)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}
get_event
Fetch a single event by id, including every corroborating article (source, url, timestamp).
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".
bash
# 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:
jsonc
// 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}}}
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:
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):
bash
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 you@example.com # 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
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.