Log inSubmit server
Newsmcp logo

Newsmcp

by pranciskus

Retrieves real-time, AI-clustered world news with topic, region, time, and importance filters.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Newsmcp

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "pranciskus-newsmcp": {
      "command": "npx",
      "args": [
        "-y",
        "@newsmcp/server"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

We couldn’t confirm it starts correctly

The install command started, but didn't respond the way we expected when we tried to talk to it.

npx -y @newsmcp/server

initialize succeeded but no response to tools/list.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

Real-time world-news retrieval is exposed by the pranciskus/newsmcp MCP server through four tools backed by a public REST API. It groups coverage from hundreds of sources into events, classifies those events by topic and geography, and ranks them using source coverage, impact, and recency. Use it when an agent needs current headlines, filtered regional or topical updates, or deeper context for a specific event. The server requires no API key and runs locally through the published npm package.

Use cases

  • Monitor top global events by recency or impact
  • Filter technology news to a continent or country
  • Retrieve source articles and context for an event
  • List available news topics and regions

Key features

  • Real-time event-based news retrieval
  • Topic, geography, and time-window filtering
  • AI clustering of related articles
  • Event detail with source articles and context
  • Sorting and pagination
  • REST API with the same news data

Tools4

What Newsmcp lets your agent do. Expand a tool for its parameters.

Self-reported~97 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

7/11 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · @newsmcp/server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars35Stargazers on the source repository.
npm downloads444Package downloads in the last 30 days.
Last commit7mo agoMost recent push to the default branch.
Install checkInconclusiveStarted but did not complete the MCP handshake in our test.
Tools exposed4Callable tools this server registers over MCP.
Directory activity6 viewsConfig copies, upvotes, and views on AllMCPs.

How Newsmcp works

What pranciskus/newsmcp MCP server does

The pranciskus/newsmcp MCP server gives AI agents access to current world-news events rather than isolated article searches. Its data is organized around events: related articles are grouped together, then labeled by topic and geographic region. Events include fields such as summaries, topic and geography tags, source counts, article counts, timestamps, and impact scores.

Coverage is organized into 12 topics, including politics, economy, technology, science, health, environment, sports, crime, military, education, and society. Regional filters cover six continents and 24 countries. The available region list should be retrieved through the server when an agent needs the exact supported slugs.

How it works

Hundreds of news sources are continuously collected and processed. Articles about the same event are grouped using vector embeddings. The resulting events are classified with topic and geographic entity tags, then ranked using source count, impact, and recency. As new articles arrive, events can be updated and duplicate reporting is merged.

The MCP process serves the same underlying data as the REST API at https://newsmcp.io/v1. The REST endpoints provide event lists, individual event details, topic categories, and region categories, while the MCP interface makes these operations available as agent tools.

Setup and configuration

Install the server with npm and configure the MCP client to run npx -y @newsmcp/server. The README provides configuration examples for Claude Desktop, Cursor, Windsurf, Claude Code, OpenAI Codex, Gemini CLI, and OpenCode. No API key or additional credential is required for the default backend.

The default API backend can be replaced by setting NEWS_API_BASE_URL in the MCP server environment. The documented example points this variable to an alternative backend URL ending in /v1; the variable is optional when using the hosted default service.

Tools and capabilities

The pranciskus/newsmcp MCP server exposes four tools:

  • get_news returns current events with optional topic, region, and time-window filters. It supports pagination and sorting by source count, impact score, last-seen time, or article count. The time window accepts 1 to 168 hours, and results are limited to a maximum of 50 per page.
  • get_news_detail accepts an event UUID from get_news and returns the event's source articles, generated context, impact analysis, and entity tags.
  • get_topics returns all available topic categories without parameters.
  • get_regions returns the supported geographic regions without parameters.

Limitations and notes

The service focuses on aggregated news events and their associated source articles. It does not require an API key, but its usefulness depends on the current data supplied by the hosted backend. Filters must use the supported topic and region slugs, and event detail lookup requires an event ID obtained from a news result. The repository also documents direct REST access for clients that do not use MCP.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Newsmcp

Run it through the published npm package with `npx -y @newsmcp/server`, then add that command to your MCP client's configuration.

No. The default setup is free and does not require an API key.

Yes. The README provides a Claude Desktop configuration using `npx -y @newsmcp/server`.

Yes. `get_news` supports comma-separated topic and geographic filters, along with a time window, pagination, and sorting.

Related MCP servers

All in Aggregators All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewNewsmcp AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/pranciskus-newsmcp?style=directory)](https://allmcps.com/mcp/pranciskus-newsmcp)
HTML Embed
<a href="https://allmcps.com/mcp/pranciskus-newsmcp"><img src="https://allmcps.com/api/badge/pranciskus-newsmcp?style=directory" alt="Newsmcp on AllMCPs" /></a>