NewsMCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add newsmcp -- npx -y @newsmcp/server
README.md

Real-time news events, clustered by AI from hundreds of sources

NewsMCP — World news for AI agents

newsmcp.io  •  integrations  •  REST 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.

Coverage

12 topicspolitics economy technology science health environment sports culture crime military education society

30 regions — 6 continents and 24 countries. Filter by europe, 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.

Integrations

Platform Package Install
Claude Desktop @newsmcp/server MCP config
Claude Code plugin newsmcp /plugin install
Claude Code MCP @newsmcp/server claude mcp add
Cursor @newsmcp/server MCP config
Windsurf @newsmcp/server MCP config
OpenAI Codex @newsmcp/server codex mcp add
Gemini CLI @newsmcp/server settings.json
OpenCode @newsmcp/server opencode mcp add
Smithery @newsmcp/server npx @smithery/cli
OpenClaw plugin @newsmcp/openclaw openclaw plugins install
OpenClaw skill newsmcp-skill clawhub install
REST API curl https://newsmcp.io/v1/news/

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "newsmcp": {
      "command": "npx",
      "args": ["-y", "@newsmcp/server"]
    }
  }
}

Claude Code Plugin

/plugin marketplace add pranciskus/newsmcp
/plugin install newsmcp

Claude Code MCP

claude mcp add newsmcp -- npx -y @newsmcp/server

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "newsmcp": {
      "command": "npx",
      "args": ["-y", "@newsmcp/server"]
    }
  }
}

Windsurf

Add to MCP config:

{
  "mcpServers": {
    "newsmcp": {
      "command": "npx",
      "args": ["-y", "@newsmcp/server"]
    }
  }
}

OpenAI Codex

codex mcp add newsmcp -- npx -y @newsmcp/server

Or add to ~/.codex/config.toml:

[mcp_servers.newsmcp]
command = "npx"
args = ["-y", "@newsmcp/server"]

Gemini CLI

Add to ~/.gemini/settings.json (or project-local .gemini/settings.json):

{
  "mcpServers": {
    "newsmcp": {
      "command": "npx",
      "args": ["-y", "@newsmcp/server"]
    }
  }
}

OpenCode

opencode mcp add

Or add to ~/.config/opencode/opencode.json (or project-local .opencode/opencode.json):

{
  "mcp": {
    "newsmcp": {
      "type": "local",
      "enabled": true,
      "command": ["npx", "-y", "@newsmcp/server"]
    }
  }
}

Smithery

npx -y @smithery/cli install @newsmcp/server --client claude

OpenClaw Plugin

openclaw plugins install @newsmcp/openclaw

No configuration needed — works out of the box. See `@newsmcp/openclaw` for options.

OpenClaw Skill

clawhub install newsmcp-skill

Lightweight alternative — a single SKILL.md that teaches the agent to call the REST API via curl. No dependencies. See `newsmcp-skill` on ClawHub.

MCP Tools

Four tools. That's the interface.

`get_news`

Top events happening right now. Filter by topic, region, time window.

Parameter Type Default Description
topics string Comma-separated topic slugs: politics,technology
geo string Comma-separated region slugs: europe,lithuania
hours number 24 Time window in hours (1–168)
page number 1 Page number
per_page number 20 Results per page (max 50)
order_by string -sources_count Sort field (see below)

Sort options: -sources_count, -impact_score, -last_seen_at, -entries_count (prefix - for descending)

`get_news_detail`

Full details on a single even

Tools (2)

get_newsFetches top news events happening right now with filtering by topic, region, and time window.
get_news_detailRetrieves full details on a single news event.

Configuration

claude_desktop_config.json
{"mcpServers": {"newsmcp": {"command": "npx", "args": ["-y", "@newsmcp/server"]}}}

Try it

What are the top technology news stories from the last 24 hours?
Find recent news events related to politics in Germany.
Get the latest science news ranked by impact score.
Show me the most important economic news from the United States.

Frequently Asked Questions

What are the key features of NewsMCP?

Real-time news event clustering from hundreds of sources. Classification by 12 topics including politics, technology, and science. Geographic filtering across 30 regions and 6 continents. Ranking system based on source count and impact score.

What can I use NewsMCP for?

Providing AI agents with up-to-date context on global events. Automating news monitoring for specific industries or regions. Building research assistants that require verified, real-time data. Aggregating news for daily briefing generation.

How do I install NewsMCP?

Install NewsMCP by running: npx -y @newsmcp/server

What MCP clients work with NewsMCP?

NewsMCP works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep NewsMCP docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare