Headline Vibes MCP Server

MCP server for analyzing sentiment of news headlines

Local serverstdio

What is the Headline Vibes MCP server?

MCP server for analyzing sentiment of news headlines. That is what the headline vibes mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The short version

Headline Vibes 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).

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

The tools it exposes

The server publishes 2 tools. What each one is for:

  • analyze_headlines — Daily sentiment snapshot for a single day. Arguments: { "input": string }. - Accepts natural language or YYYY-MM-DD. - Returns investor/general
  • analyze_monthly_headlines — Monthly aggregation between two months. Arguments: { "startMonth": "YYYY-MM", "endMonth": "YYYY-MM" }. - Outputs per-month political sentiments

What it needs from you

Configuration is passed through the environment: NEWS_API_KEY, TRANSPORT. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Getting it running

npm on npm is all you need. Most clients run it directly, so configuration is a few lines and a restart.

How it compares

This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Headline Vibes's toolset — analyze_headlines, analyze_monthly_headlines — is a fair guide to whether it matches your workflow. It is maintained by fred-em; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
analyze_headlinesDaily sentiment snapshot for a single day. Arguments: { "input": string }. - Accepts natural language or YYYY-MM-DD. - Returns investor/general scores, synopses, distributions, sample headlines, and diagnostics.
analyze_monthly_headlinesMonthly aggregation between two months. Arguments: { "startMonth": "YYYY-MM", "endMonth": "YYYY-MM" }. - Outputs per-month political sentiments, headline counts, and token/sampling diagnostics.

How to install the Headline Vibes MCP server

{
  "mcpServers": {
    "headline-vibes": {
      "command": "npx",
      "args": ["-y", "npm"],
      "env": {
        "NEWS_API_KEY": "your-value",
        "TRANSPORT": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
NEWS_API_KEYCredential the server authenticates with.Yes
TRANSPORTConfiguration value read at startup.Optional

Example prompts to try

  • Use Headline Vibes to analyze headlines.
  • Use Headline Vibes to analyze monthly headlines.

Frequently asked questions

It connects Headline Vibes to MCP-compatible AI assistants such as Claude and Cursor, exposing 2 tools (analyze_headlines, analyze_monthly_headlines) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Headline Vibes directly.