# 📰 News MCP Server

FastMCP-based MCP server that turns RSS into **deduplicated, enriched news clusters**.

## Quick start

```bash
cd news-mcp
source .venv/bin/activate
pip install -r requirements.txt
./run.sh
```

Default SSE mount (FastMCP):
- `http://127.0.0.1:8506/mcp/sse`

Health:
- `http://127.0.0.1:8506/health`

## What this server provides
- Fetches RSS from `https://breakingthenews.net/news-feed.xml`
- Deduplicates articles into clusters (v1 fuzzy title similarity)
- Enriches clusters with Groq (topic/entities/sentiment/keywords)
- Caches clusters + Groq fields in SQLite

## Tools (MCP)

1) `get_latest_events(topic, limit)`
- `topic` is a coarse category: `crypto | macro | regulation | ai | other`

2) `get_events_for_entity(entity, limit)`
- substring, case-insensitive match over extracted `entities`

3) `get_event_summary(event_id)`
- Groq-written compressed narrative for a given `cluster_id`

4) `detect_emerging_topics(limit)`
- derives “emerging” signals from recent cached clusters

## Configuration

See `news-mcp/.env`.
Key variables:
- `GROQ_API_KEY`, `GROQ_MODEL`, `GROQ_DEBUG`
- `NEWS_REFRESH_INTERVAL_SECONDS` (default 900)
- `NEWS_BACKGROUND_REFRESH_ON_START` (default true)
- `NEWS_CLUSTERS_TTL_HOURS`