Headline Vibes

MCP Server - get a heat check headlines

typescript

6

GitHub Stars

typescript

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "fred-em-headline-vibes": {
      "command": "node",
      "args": [
        "/absolute/path/headline-vibes/build/index.mjs"
      ],
      "env": {
        "TRANSPORT": "stdio",
        "NEWS_API_KEY": "YOUR_EVENTREGISTRY_KEY"
      }
    }
  }
}

Headline Vibes is a Model Context Protocol server that analyzes investor sentiment in US news headlines fetched from EventRegistry. It supports daily and monthly analyses, outputs structured results with diagnostics, and can run over stdio or HTTP for flexible deployments.

How to use

You run Headline Vibes as an MCP server and connect to it with your MCP client to request daily or monthly sentiment analyses. Use the stdio option for local development or testing, or switch to HTTP for remote deployments. You will receive structured JSON outputs with investor and general sentiment scores, as well as diagnostics and sampling information to help you interpret the results.

How to install

Prerequisites: Install Node.js v18+ (LTS recommended) and obtain an EventRegistry API key.

Step by step commands to set up and run Headline Vibes in stdio mode.

npm install
npm run build

# Configure environment and run in stdio mode (example)

{
  "mcpServers": {
    "headline_vibes": {
      "command": "node",
      "args": ["/absolute/path/headline-vibes/build/index.mjs"],
      "env": {
        "NEWS_API_KEY": "your-eventregistry-key",
        "TRANSPORT": "stdio"
      }
    }
  }
}

Additional sections

Configuration, security, examples, and troubleshooting notes help you get reliable results from Headline Vibes. The server exposes daily and monthly analysis endpoints, includes token budgeting and rate-limit telemetry, and outputs data compatible with MCP structuredContent.

Available tools

analyze_headlines

Daily sentiment snapshot endpoint that analyzes headlines for a single day. Returns investor/general scores, synopses, distributions, sample headlines, and diagnostics.

analyze_monthly_headlines

Monthly aggregation endpoint that analyzes headlines across a range of months. Returns per-month political sentiments, counts, and token/sampling diagnostics.