Newsflash

sh.newsflashPublished by newsflash.shOfficial publisherv1.0.2Updated Oct 24, 2026

Real-time corroborated news events + 5-year archive, for agents. Free tier, no key.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingData & Analytics

Overview

AI-generated overview

Newsflash is a hosted news service that lets an assistant query a deduplicated, corroborated event graph built from 260+ outlets, with a five-year archive.

What you can do
Query deduplicated news events by theme, source, category and time window, with corroboration counts and confidence scores, and fetch a single event with all its corroborating articles and URLs. Search raw, uncollapsed articles for per-outlet coverage. List tracked news sources with categories and live article counts, and check corpus size and freshness.
When to use it
Useful when an assistant needs current news as a signal rather than a pile of links: headlines, briefings, tracking how widely a story is corroborated, or backtesting against historical news events.
Requirements
A remote MCP endpoint over Streamable HTTP; nothing to install locally. Works without a key on a test tier (50 requests per day, 24-hour lookback). An optional API key, sent as an Authorization Bearer header, raises limits; a free key is obtained by email. The full five-year archive requires a paid subscription.
Before you install
The Authorization header carries an API key; keys are shown once and stored only as hashes. The premium tier is a paid subscription at $29 per month. Requests are rate-limited and reset at midnight UTC, and the keyless tier is capped per IP. Queries go to a third-party hosted service.

Installation

In SourceWeft

  1. Open Newsflash in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/sh.newsflash%2Fnewsflash/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "newsflash": {
      "type": "http",
      "url": "https://newsflash.sh/mcp"
    }
  }
}

README

[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".

bash
# 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:

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

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):

bash
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:

MethodRoutePurpose
GET/api/events?q=&source=&category=&from=&to=&limit=Deduped events
GET/api/events/:idOne event + corroborating articles
GET/api/articles?…Raw article search
GET/api/sourcesTracked sources + counts
GET/api/stats · /api/healthCorpus size & freshness
GET/api/streamReal-time SSE push — event.new / event.corroborated as clustering commits
POST/mcpMCP 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

TierAuthLimitHow
testnone50 req/day (per IP) · 24h lookback · 1 streamjust call the API or MCP endpoint
freeAPI key1,000 req/day · 30-day lookback · 2 streamsnewsflash login — email + one-time code
premiumsubscription50,000 req/day · full 5-year archive · 10 streamsnewsflash 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]

Source: README.md at commit 6d61a95

Tools

5

get_events

Search news 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. For headlines, briefings, or 'what's happening' asks, pass min_sources: 2 (or 3 for high signal) — the raw recency feed is dominated by single-outlet local stories without it. ONE call is normally enough: trust each event's corroboration (distinct outlets), confidence (0-1; 1.0 = fully corroborated), and sources list as-is, and present the top events directly, including each event's url as its link — do NOT call get_event per item or re-verify counts (only drill in when the user wants EVERY outlet's link for one story). The corpus spans 260+ global outlets and a five-year archive (history visible depends on tier).

Parametersqtofromlimitsourcecategorysemanticmin_sources

get_event

Get event details

Fetch a single event by id, including every corroborating article (source, url, timestamp).

Parametersidrequired

search_articles

Search raw articles

Search raw articles (not collapsed into events). Use when you want the underlying items or need per-outlet coverage rather than deduped happenings.

Parametersqtofromlimitsourcecategory

list_sources

List sources

List all news sources Newsflash tracks, with categories and live article counts.

Takes no parameters.

corpus_stats

Corpus stats

Corpus size and freshness: source / article / event counts and the latest article timestamp.

Takes no parameters.

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts