NewsMCP — Real-time news for AI agents
LocalAbout NewsMCP — Real-time news for AI agents
NewsMCP is an MCP server that provides real-time news events clustered by AI from hundreds of sources. Events are classified by topic and geography and ranked by importance. It requires no API key and installs with a single npx command.
Key features
- 01Real-time news events clustered by AI
- 02Classification by topic and geographic region
- 03Ranking by importance
- 04Event detail with context and all sources
- 05REST API access to the same data
Use cases
- 01Giving an AI agent an overview of current world news
- 02Filtering news events by topic or region
- 03Reviewing full sources and context for a single event
MCP support
The project runs as an MCP server and exposes four tools to MCP clients: get_news, get_news_detail, get_topics and get_regions.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
4Saved tool list · updated 3w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| topics | string | No | Comma-separated topic slugs (e.g. 'politics,technology'). Use get_topics to see available topics. |
| geo | string | No | Comma-separated geographic slugs (e.g. 'europe,lithuania'). Use get_regions to see available regions. |
| hours | integer | No | Time window in hours (1-168). Default: 24. |
| page | integer | No | Page number. Default: 1. |
| per_page | integer | No | Results per page (1-50). Default: 20. |
| order_by | enum | No | Sort order. Default: -sources_count (most covered first).-sources_count | -impact_score | -last_seen_at | -entries_count | sources_count | impact_score | last_seen_at | entries_count |
Details
From the project README@newsmcp/server
World news for AI agents. Real-time events clustered by AI from hundreds of sources, classified by topic and geography, ranked by importance.
Free. No API key. One command.
npx -y @newsmcp/server
Website: newsmcp.io Full docs: github.com/pranciskus/newsmcp
Install
Claude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"newsmcp": {
"command": "npx",
"args": ["-y", "@newsmcp/server"]
}
}
}
Claude Code: claude mcp add newsmcp -- npx -y @newsmcp/server
Cursor — add to .cursor/mcp.json:
{
"mcpServers": {
"newsmcp": {
"command": "npx",
"args": ["-y", "@newsmcp/server"]
}
}
}
Tools
| Tool | Description |
|---|---|
get_news | Top events with topic/geo/time filtering |
get_news_detail | Full event detail with context and all sources |
get_topics | Available topic categories |
get_regions | Available geographic regions (100+) |
REST API
Same data without MCP. Base URL: https://newsmcp.io/v1
curl -s https://newsmcp.io/v1/news/ | jq
curl -s "https://newsmcp.io/v1/news/?topics=technology&geo=europe" | jq
curl -s https://newsmcp.io/v1/news/topics/ | jq
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.