newsmcp
About
Real-time world news for AI agents — events clustered from hundreds of sources, classified by 12 topics and 30+ regions, ranked by importance. Free, no API key.
Details
- Transport
- SSE
Explore
Setup
Install newsmcp in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/pranciskus/newsmcp
Follow the installation instructions in the repository README, then restart your MCP client.
news
Search already-synthesized news events — pre-built story digests — or fetch one by id. Each story comes with a generated headline, one-liner, abstract, key actors, and industry/event-type labels. Use it for a quick digest of what happened, for deal/incident-type or industry filtering, and for corroboration ranking. Nothing is required: a bare call returns the most-corroborated stories of the last 24 hours. Limits — keyless: 7-day `from_` lookback, 20 calls/hour, 20 stories per call, over-lim…
get_story
Expand one story: full summary, classification, actors, and source links. Use this after any search, when the user wants more than the digest line for a particular story. It is the only tool that can return a story's complete source list.
check_coverage
Judge how widely and how independently a claim has been reported. Answers "is this real?" rather than returning a list. Reports the number of INDEPENDENT newsrooms — outlets that reported it themselves — separately from the number of domains that carried it, which includes syndication. A story on 200 domains from 3 newsrooms is one story reprinted, not 200 confirmations. Because upstream clustering splits a story across languages, this totals the likely variants of the same story and presen…
check_limits
Report what this caller may do right now — and never spend any of it to find out. Answers the questions the `news` tool descriptions cannot: how many searches are left this hour, how far back this plan reaches, the largest `limit` it allows, how many searches may run at once, and how long to wait if the budget is spent. These ceilings are per-plan and change without a release, so trust this over any number written into a description. Checking is free: the endpoint is exempt from every meter…
check_health
Check whether the NewsMCP REST API is reachable and healthy. Does not require an API token. Use when diagnosing connectivity, not for searching news. For allowances and remaining budget use `check_limits` instead. Returns: str: Health status reported by the API.
Real-time news events, clustered by AI from hundreds of sources, classified by topic and geography, ranked by importance.
Free. No API key. One command to install.
12 topics—politicseconomytechnologysciencehealthenvironmentsportsculturecrimemilitaryeducationsociety
30 regions— 6 continents and 24 countries. Filter byeurope,asia,united-states,germany,japan,ukraine, and more.
Hundreds of sources— Articles clustered into events in real-time, ranked by source count and impact score.
{ "mcpServers": { "newsmcp": { "command": "npx", "args": ["-y", "@newsmcp/server"] } } }
/plugin marketplace add pranciskus/newsmcp /plugin install newsmcp
claude mcp add newsmcp -- npx -y @newsmcp/server
{ "mcpServers": { "newsmcp": { "command": "npx", "args": ["-y", "@newsmcp/server"] } } }
{ "mcpServers": { "newsmcp": { "command": "npx", "args": ["-y", "@newsmcp/server"] } } }
codex mcp add newsmcp -- npx -y @newsmcp/server
[mcp_servers.newsmcp] command = "npx" args = ["-y", "@newsmcp/server"]
Add to~/.gemini/settings.json(or project-local.gemini/settings.json):
{ "mcpServers": { "newsmcp": { "command": "npx", "args": ["-y", "@newsmcp/server"] } } }
Or add to~/.config/opencode/opencode.json(or project-local.opencode/opencode.json):
{ "mcp": { "newsmcp": { "type": "local", "enabled": true, "command": ["npx", "-y", "@newsmcp/server"] } } }
npx -y @smithery/cli install @newsmcp/server --client claude
openclaw plugins install @newsmcp/openclaw
No configuration needed — works out of the box. See@newsmcp/openclawfor options.
Lightweight alternative — a single SKILL.md that teaches the agent to call the REST API viacurl. No dependencies. Seenewsmcp-skillonClawHub.
Top events happening right now. Filter by topic, region, time window.
Sort options:-sources_count,-impact_score,-last_seen_at,-entries_count(prefix-for descending)
Full details on a single event — all source articles, AI-generated context, impact analysis, entity tags.
Lists every topic category available for filtering. No parameters.
crimecultureeconomyeducationenvironmenthealthmilitarypoliticssciencesocietysportstechnology
Lists every geographic region — 6 continents and 24 countries — available for filtering. No parameters.
Don't need MCP? Hit the endpoints directly. Same data, same filters.
All parameters are optional. Combine freely.
# Latest events curl -s https://newsmcp.io/v1/news/ | jq # Filter by topic curl -s "https://newsmcp.io/v1/news/?topics=technology" | jq # Filter by region curl -s "https://newsmcp.io/v1/news/?geo=europe" | jq # Last 12 hours, sorted by impact curl -s "https://newsmcp.io/v1/news/?hours=12&order_by=-impact_score" | jq # Combine everything curl -s "https://newsmcp.io/v1/news/?topics=politics&geo=united+states&hours=48&per_page=5" | jq
{ "events": [ { "id": "cc3428ab-2ada-41bb-86ab-833fd39ffd8d", "summary": "Event description with AI-generated context...", "topics": ["technology", "politics"], "geo": ["united states"], "entries_count": 86, "sources_count": 45, "first_seen_at": "2026-02-15T04:06:41.728Z", "last_seen_at": "2026-03-03T05:00:30Z", "impact_score": 8, "entries": [ { "title": "Article headline", "url": "https://source.com/article", "domain": "source.com", "published_at": "2026-03-03T05:00:30Z" } ] } ], "total": 142, "page": 1, "per_page": 20 }
- Collect— Hundreds of news sources are scraped continuously
- Cluster— Articles about the same event are grouped using vector embeddings
- Classify— Each event is tagged with topics and geographic entities
- Rank— Events are scored by source count, impact, and recency
- Serve— Clean JSON via REST API and MCP server
Events update in real-time as new articles appear. The clustering AI merges duplicate coverage automatically.
{ "mcpServers": { "newsmcp": { "command": "npx", "args": ["-y", "@newsmcp/server"], "env": { "NEWS_API_BASE_URL": "https://your-api.example.com/v1" } } } }
Publishing is tag-driven via.github/workflows/release.yml:
- Trigger: push tagv..*
- Publishes@newsmcp/serverand@newsmcp/openclawto npm via Trusted Publishing (OIDC)
- Publishes MCP metadata withmcp-publisher login github-oidc
- Creates a GitHub release with generated notes
- npm package settings: For@newsmcp/serverand@newsmcp/openclaw, add a Trusted Publisher pointing to:
- Owner:pranciskus
- Repository:newsmcp
- Workflow file:.github/workflows/release.yml
- Environment: leave empty (unless you intentionally use one)
- Bump versions in:
- packages/mcp-server/package.json
- packages/openclaw-plugin/package.json
- packages/mcp-server/server.json
- package-lock.json
git tag -a vX.Y.Z -m "vX.Y.Z" git push origin vX.Y.Z
The workflow does the publish and GitHub release automatically.
newsmcp/ ├── .github/workflows/ # CI/CD workflows (release automation) ├── .claude-plugin/ # Marketplace manifest ├── packages/ │ ├── mcp-server/ # @newsmcp/server — MCP server (npm) │ ├── claude-code-plugin/ # newsmcp — Claude Code plugin │ ├── openclaw-plugin/ # @newsmcp/openclaw — OpenClaw plugin (npm) │ └── skill/ # newsmcp-skill — OpenClaw skill (ClawHub) ├── publish.sh # Build, test, publish workflow ├── README.md └── LICENSE
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
Multi-source news aggregation for AI agents — RSS/Atom feeds (16 sources), HackerNews, and GDELT global news intelligence in 65+ languages. No API key required.
AI-powered news intelligence — 21 tools for personalized monitoring, briefings, and semantic search
Agent News by The Agent Times gives AI agents a verified, sourced, real-time intelligence layer, that helps to save tokens, time and keep agents in the loop.
A server for conducting deep research and generating reports.
An MCP (Model Context Protocol) server that gives AI assistants real-time news fetching, search, NLP analysis, and personalized news preferences — all accessible through natural language.
A simple MCP server that brings Hacker News into your AI workflows. It exposes a set of tools to fetch top stories, individual posts with comments, and the latest Ask HN / Show HN discussions — all in a clean, structured format that’s easy for agents
Real-time news with bias scoring across 5,000+ sources and 15+ dimensions, balanced news synthesis, live market data with AI analysis, ML options pricing, and semantic meme search.
Free AI-industry intelligence for agents: briefings, regulation tracker & regional lenses
Generate express market research reports from 9 verified sources (Wikipedia, Google News, GitHub, HN, SO, arXiv, npm, Reddit, PyPI). TAM/SAM/SOM, SWOT, HTML reports.
All your RSS feeds aggregated in one place. Eloa highlights what's new, shows the source, and how long ago it was published. Filter by read and unread.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
