Headline Vibes Analysis MCP Server

by fred-em

Integrations

  • Pulls headlines from CNN for sentiment analysis

  • Pulls headlines from Fox News for sentiment analysis

  • Pulls headlines from NBC News for sentiment analysis

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

Installation

  1. Clone the repository:
git clone https://github.com/fred-em/headline-vibes.git cd headline-vibes
  1. Install dependencies:
npm install
  1. Build the server:
npm run build
  1. 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

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Analyzes sentiment in news headlines from major US publications using both standard and natural language date inputs, enabling insights into public sentiment trends.

  1. Features
    1. Prerequisites
      1. Installation
        1. Available Tools
          1. analyze_headlines
        2. Response Format
          1. News Sources
            1. Error Handling
              1. Development
                1. License

                  Related MCP Servers

                  • A
                    security
                    A
                    license
                    A
                    quality
                    This is a TypeScript-based MCP server that allows searching for New York Times articles from the last 30 days based on a keyword.
                    Last updated -
                    1
                    5
                    8
                    JavaScript
                    MIT License
                    • Apple
                  • -
                    security
                    F
                    license
                    -
                    quality
                    An MCP server offering AI-driven social mention analysis via Syften's API, featuring real-time notifications and trend analysis.
                    Last updated -
                    1
                    JavaScript
                  • A
                    security
                    A
                    license
                    A
                    quality
                    Provides tools to fetch and search news from The Verge's RSS feed, allowing users to get today's news, retrieve random articles from the past week, and search for specific keywords in recent Verge content.
                    Last updated -
                    3
                    1
                    TypeScript
                    MIT License
                    • Apple

                  View all related MCP servers

                  ID: jkojbe4jve