newsagentdata/newsagent-mcp
🐍 ☁️ - Real-time, ML-enriched news intelligence — urgency scoring, political lean & event clustering across 190+ countries.
Quick Install
{
"mcpServers": {
"newsagentdata-newsagent-mcp": {
"command": "npx",
"args": [
"-y",
"newsagentdata-newsagent-mcp"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
NewsAgent Data — MCP server
Query scored, classified Russian & English news from any MCP client (Claude Desktop, Cursor, Cline, etc.). The server wraps the NewsAgent Data API — every article it returns is already scored for urgency (0–10), classified by political lean, topic, country and audience, and de-duplicated.
Tools
| Tool | What it does |
|---|---|
get_feed | Filtered feed — by country, topic, language, political lean, audience, min urgency, date range |
search_news | Full-text keyword search across the archive |
get_breaking | Recent high-urgency news (urgency ≥ 7 by default) |
coverage_stats | Live totals — articles, sources, countries, languages (no key) |
list_sources | Source catalog metadata (Standard tier+) |
Setup
- Get a free API key: https://newsagentdata.com/signup/?plan=free
- Install deps:
pip install -r requirements.txt - Add to your MCP client config. Claude Desktop (
claude_desktop_config.json):
{
"mcpServers": {
"newsagent": {
"command": "python",
"args": ["/absolute/path/to/newsagent_mcp.py"],
"env": { "NEWSAGENT_API_KEY": "your_key_here" }
}
}
}
Cursor / Cline: point the MCP server command at newsagent_mcp.py the same way, with NEWSAGENT_API_KEY in the env.
- Restart the client. The five tools appear automatically.
Example prompts
- "Get breaking sanctions news from Russia scored 7 or higher."
- "Search the news for 'central bank rate' in the last 14 days, English only."
- "Compare how state vs opposition sources covered Ukraine this week." (uses
get_feedwithpolitical_lean) - "What's the live coverage — how many countries and sources?"
The agent picks the right tool and filters; results come back pre-scored and classified, so no NLP pipeline is needed on your side.
Notes
- Free/Developer tiers have a history window (1–7 days) and daily quotas; the server surfaces 401/403/429 as clear errors.
list_sourcesrequires a Standard-tier key; channel handles are never exposed.- Set
NEWSAGENT_API_BASEto override the API host (defaults tohttps://api.newsagentdata.com).