pranciskus/newsmcp

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 topics** — politics 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:
Claude Code Plugin
Claude Code MCP
Cursor
Add to .cursor/mcp.json:
Windsurf
Add to MCP config:
OpenAI Codex
Or add to ~/.codex/config.toml:
Gemini CLI
Add to ~/.gemini/settings.json (or project-local .gemini/settings.json):
OpenCode
Or add to ~/.config/opencode/opencode.json (or project-local .opencode/opencode.json):
Smithery
OpenClaw Plugin
No configuration needed — works out of the box. See @newsmcp/openclaw for options.
OpenClaw 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 event — all source articles, AI-generated context, impact analysis, entity tags.
| Parameter | Type | Description |
|-----------|------|-------------|
| event_id | string | Event UUID from get_news results |
get_topics
Lists every topic category available for filtering. No parameters.
crime culture economy education environment health military politics science society sports technology
get_regions
Lists every geographic region — 6 continents and 24 countries — available for filtering. No parameters.