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 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:
{
"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
{"mcpServers": {"newsmcp": {"command": "npx", "args": ["-y", "@newsmcp/server"]}}}