Overtone News Mcp
by CKBrennancommunityv0.1.2
1
An MCP server that provides real-time news articles along with analysis tools for tone distribution, emerging stories, narrative shifts, spike detection, and tone-over-time trends. It is designed for MCP clients to help agents reason about current events from contextualized news signals rather than a flat headline feed.
From the registry: Real-time news with tone analysis, brand safety, and narrative shift signals for AI agents.
Install & configure
Prerequisites
- requiredInstall uvInstall the uv Python package manager so you can run the MCP server via uvx without a global package install.
https://docs.astral.sh/uv/uv/$ curl -LsSf https://astral.sh/uv/install.sh | sh
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `overtone-news-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install uv** — Install the uv Python package manager so you can run the MCP server via uvx without a global package install. Run: `curl -LsSf https://astral.sh/uv/install.sh | sh` (https://docs.astral.sh/uv/uv/)
Canonical MCP server config (stdio transport):
- command: `uvx`
- args: ["overtone-news-mcp"]
- optional environment variables:
- `OVERTONE_NEWS_API_KEY`: Use a specific Overtone News API key instead of auto-registering a free-tier key on first tool call. Recommended for premium access or to opt out of auto-registration. (example: `<your-overtone-news-api-key>`)
- `OVERTONE_NEWS_API_URL`: Override the Overtone News API endpoint for self-hosted deployments or testing. (example: `<your-overtone-news-api-url>`)
Note: The default and preferred install path is running the published PyPI package with uvx. If OVERTONE_NEWS_API_KEY is not set, the server auto-registers a free-tier key on first use and caches it at ~/.overtone/credentials.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: The default and preferred install path is running the published PyPI package with uvx. If OVERTONE_NEWS_API_KEY is not set, the server auto-registers a free-tier key on first use and caches it at ~/.overtone/credentials.
Tools (7)
news
Returns articles on a topic with tone, brand-safety signals, article type, and concepts.
tone
Shows emotional tone distribution and dominant tone for recent coverage of a topic.
pulse
Detects spikes in watched tones versus a baseline window and returns alerts when meaningful spikes occur.
emerging
Lists concepts that appeared in the last 24 hours after having zero coverage in the prior 48 hours.
velocity
Finds concepts whose tone distribution shifted most sharply between two recent time windows.
timeseries
Returns tone trajectory over time for a topic in hourly, 6-hour, or daily bins.
report
Logs which displayed URLs were actually shown to the user after presenting articles.
Environment variables
OVERTONE_NEWS_API_KEYrequiredProvides a specific API key instead of auto-registering a free-tier key.Packages
overtone-news-mcp
pypiv0.1.2transport: stdio
Details
- Language
- Python
- License
- MIT
- Released
- May 4, 2026
- Last commit
- May 4, 2026
- Registry name
- io.github.CKBrennan/overtone-news-mcp