The Headline Vibes Analysis MCP Server analyzes sentiment in news headlines from major US publications.

Analyze Sentiment: Evaluates up to 100 headlines per request on a scale of 0 (most negative) to 10 (most positive).
Date Flexibility: Supports both natural language date input (e.g., "yesterday", "last Friday") and specific date formats (e.g., "2025-02-11").
Source Diversity: Pulls headlines from major US news sources like Reuters, CNN, Associated Press, and Wall Street Journal.
Detailed Results: Provides sentiment score, synopsis, number of headlines analyzed, source distribution, and up to 5 sample headlines.
Error Handling: Includes clear error messages for issues like invalid dates or API errors.
Development Support: Offers watch mode for real-time server testing during development.

Headline Vibes Analysis MCP Server

A Model Context Protocol server that analyzes sentiment in news headlines from major US publications. The server provides both a standard date-based interface and natural language date parsing for easier use.

Features

Analyzes up to 100 headlines per request
Even distribution of headlines across major US news sources
Sentiment scoring on a 0-10 scale (0 = most negative, 10 = most positive)
Natural language date parsing (e.g., "yesterday", "last Friday")
Detailed source distribution information
Sample headlines included in results

Related MCP server: MCP News Server

Prerequisites

Node.js v16 or higher
NewsAPI key (get one at https://newsapi.org)

Installation

Clone the repository:

git clone https://github.com/fred-em/headline-vibes.git cd headline-vibes

Install dependencies:

npm install

Build the server:

npm run build

Configure your NewsAPI key in your MCP settings file:

{ "mcpServers": { "headline-vibes": { "command": "node", "args": ["/path/to/headline-vibes/build/index.mjs"], "env": { "NEWS_API_KEY": "your-api-key-here" }, "disabled": false, "autoApprove": [] } } }

Available Tools

analyze_headlines

Analyze sentiment using natural language date input or specific dates.

Example usage:

// Using natural language { "name": "analyze_headlines", "arguments": { "input": "yesterday" } } // Or using specific dates { "name": "analyze_headlines", "arguments": { "input": "2025-02-11" } }

Input examples:

"last Friday"
"3 days ago"
"March 10th"
"two weeks ago"
"2025-02-11" (YYYY-MM-DD format also supported)

Response Format

The tool returns results in the following format:

{ "score": "6.50", // Normalized sentiment score (0-10) "synopsis": "Overall positive sentiment in today's headlines", "headlines_analyzed": 100, // Number of headlines analyzed "sources_analyzed": 12, // Number of unique sources "source_distribution": { // Distribution of headlines by source "Reuters": 10, "Associated Press": 8, "CNN": 9, // ... etc }, "sample_headlines": [ // Up to 5 sample headlines "Example headline 1", "Example headline 2", // ... etc ] }

News Sources

The server pulls headlines from major US news sources including:

Associated Press
Reuters
CNN
Fox News
NBC News
ABC News
Wall Street Journal
Washington Post
USA Today
Bloomberg
Business Insider
Time

Error Handling

The server provides clear error messages for common issues:

Invalid date formats
Unparseable natural language queries
No headlines found for the specified date
API errors from NewsAPI

Development

To run the server in watch mode during development:

npm run watch

License

MIT

Headline Vibes Analysis MCP Server

Headline Vibes Analysis MCP Server

Features

Prerequisites

Installation

Available Tools

analyze_headlines

Response Format

News Sources

Error Handling

Development

License

Resources

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API