What is Headline Vibes

Headline-vibes is an MCP Server that analyzes sentiment in news headlines from major US publications, providing insights into the emotional tone of the news.

Use cases

Use cases include monitoring sentiment trends over time, comparing sentiment across different news sources, and generating reports on public perception based on news headlines.

How to use

To use headline-vibes, clone the repository, install dependencies, build the server, and configure your NewsAPI key. You can analyze headlines by providing natural language date inputs or specific dates.

Key features

Key features include analyzing up to 100 headlines per request, sentiment scoring on a 0-10 scale, natural language date parsing, detailed source distribution information, and inclusion of sample headlines in results.

Where to use

Headline-vibes can be used in media analysis, sentiment tracking, news aggregation platforms, and any application that requires understanding public sentiment from news headlines.

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

1. Clone the repository:

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

2. Install dependencies:

npm install

3. Build the server:

npm run build

4. 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:

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