Headline Vibes Analysis MCP Server

Name: Headline Vibes Analysis MCP Server
Author: fred-em

@fred-em

Repository

About Headline Vibes Analysis MCP Server

MCP Server - get a heat check headlines

#headline-vibes #sentiment-analysis #news-analysis

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "headline-vibes": {
      "command": "node",
      "args": [
        "/path/to/headline-vibes/build/index.mjs"
      ],
      "env": {
        "NEWS_API_KEY": ""
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Headline Vibes Analysis MCP Server?

Headline Vibes Analysis MCP Server is a Model Context Protocol server that analyzes investor sentiment in US news headlines fetched from EventRegistry (newsapi.ai). It supports daily and monthly analysis modes, produces structured outputs with diagnostics, and runs over stdio or HTTP (Railway-ready).

How to use Headline Vibes Analysis MCP Server?

Install Node.js v18+, obtain an EventRegistry API key, install dependencies, and build the project. Configure the environment with NEWS_API_KEY and TRANSPORT (stdio or http). Invoke the tools analyze_headlines (daily) with a natural language date or YYYY-MM-DD, and analyze_monthly_headlines with startMonth and endMonth parameters.

Key features of Headline Vibes Analysis MCP Server

Curated US newsroom coverage with investor relevance filtering
Dual sentiment scores (general + investor) normalized to 0–10 scale
Political-leaning breakdowns, source distributions, and sampling diagnostics
Natural-language date parsing for daily requests
Structured JSON outputs compatible with MCP structuredContent
Built-in token budgeting and rate-limit telemetry

Use cases of Headline Vibes Analysis MCP Server

Daily investor sentiment snapshot for a single day
Monthly aggregation tracking sentiment trends between months
Political leaning analysis across news sources over time
Source distribution and sampling diagnostics for research

FAQ from Headline Vibes Analysis MCP Server

What data source does Headline Vibes Analysis MCP Server use?

It uses EventRegistry (newsapi.ai) to fetch US news headlines with investor relevance filtering.

What are the runtime requirements?

Node.js v18+ (LTS recommended) and an EventRegistry API key.

How do I switch between transport modes?

Set the TRANSPORT environment variable to "stdio" for stdio mode or "http" for HTTP mode (Railway-ready).

How does the sentiment scoring work?

It provides dual scores (general and investor) normalized to a 0–10 scale, along with political-leaning breakdowns.

Are there built-in rate limits or token budgets?

Yes, the server includes built-in token budgeting and rate-limit telemetry for efficient API usage.

Comments

More Other MCP servers

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K