Newsflash

[Newsflash]

Newsflash

[npm] [smithery badge]

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 shellnpx newsflash events -q "etf" -c crypto -n 5npx newsflash stream -c crypto --min-sources 2   # the live wire, corroborated onlycurl "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 5newsflash events --json -q fed | jq '.[0].sources'   # --json for agentsnewsflash sourcesnewsflash statsnewsflash login [email protected]    # free API key via emailed one-time codenewsflash me                       # tier + today's usage

HTTP API

Base URL https://newsflash.sh:

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

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]