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
Prerequisites
- Node.js v16 or higher
- NewsAPI key (get one at https://newsapi.org)
Installation
- Clone the repository:
- Install dependencies:
- Build the server:
- Configure your NewsAPI key in your MCP settings file:
Available Tools
analyze_headlines
Analyze sentiment using natural language date input or specific dates.
Example usage:
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:
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:
License
MIT