Newsflash MCP server
Commit Aug 27, 2026Lets an AI client query a deduped event graph of corroborated news events from 260+ outlets with a five-year archive.
Also known as zatmonkey/newsflash
- Stars
- 2
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.2
- Last commit
- Aug 27, 2026
- License
- MIT
What is Newsflash MCP?
Newsflash lets an AI client query a deduped event graph of corroborated news events from 260+ outlets with a five-year archive.
Summary generated from the project's README
About Newsflash MCP server
Querying a deduplicated graph of corroborated news events is what Newsflash enables for AI agents and developers. Instead of processing individual articles, users interact with a structured event graph that collapses noise from over 260 global outlets into single, verified happenings. This service is hosted remotely, meaning there is no local server to install, and it can be connected to Claude Desktop, Cursor, or ChatGPT via a Streamable HTTP transport.
Users can access the data through several interfaces including a command line tool, a real-time SSE stream, or a REST API. The system provides a confidence score based on how many independent sources report a story, helping agents distinguish between rumors and major news. While anyone can start with a keyless test drive limited to 50 requests per day and a 24-hour lookback, a free API key increases limits to 1,000 requests and a 30-day history. Premium subscribers gain access to the full five-year archive and much higher daily request limits.
What you can do with it
- 1Setting up automated news briefingsUsers can instruct an agent to interview them about their interests and schedule personalized daily updates.
- 2Monitoring real-time breaking newsDevelopers can subscribe to a live stream to receive instant updates as news events are corroborated.
Written from the project's README. Every use case is checked against a quote from it.
How to install Newsflash MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Newsflash MCP in Claude Code
$ claude mcp add --transport http newsflash https://newsflash.sh/mcpInstall Newsflash MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"newsflash": {
"url": "https://newsflash.sh/mcp"
}
}
}Install Newsflash MCP in VS Code
.vscode/mcp.json
{
"servers": {
"newsflash": {
"type": "http",
"url": "https://newsflash.sh/mcp"
}
}
}Install Newsflash MCP in VS Code CLI
$ code --add-mcp '{"name":"newsflash","type":"http","url":"https://newsflash.sh/mcp"}'Install Newsflash MCP in Codex
$ codex mcp add newsflash --url https://newsflash.sh/mcpInstall Newsflash MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.newsflash] url = "https://newsflash.sh/mcp"
Install Newsflash MCP in Gemini CLI
$ gemini mcp add -s user --transport http newsflash https://newsflash.sh/mcpInstall Newsflash MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"newsflash": {
"url": "https://newsflash.sh/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablezatmonkey/newsflash is public and reachablegithub.com/zatmonkey/newsflash ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-27github.com/zatmonkey/newsflash ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 123 msPass
README
View on GitHubNewsflash
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.shis a domain, not a shell script. There is no local binary or server to install: callhttps://newsflash.sh/api/*(REST) orhttps://newsflash.sh/mcp(MCP) directly. Verify withcurl "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 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 |
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 · contact@newsflash.sh
Newsflash MCP questions
How do I add Newsflash MCP to Claude Code?
Run claude mcp add --transport http newsflash https://newsflash.sh/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Newsflash MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Do I need an account to start using Newsflash?
No, you can start without an account using the test tier which allows 50 requests per day per IP.
How can I use Newsflash with Claude Desktop?
You can connect by going to Settings → Connectors → Browse connectors, searching for 'Newsflash', and clicking Connect.
How does the news corroboration work?
The system uses trigram similarity to match articles to events; confidence is calculated as the minimum of 1 or the number of distinct sources divided by 3.