Headline Vibes

by fred-em

4 stars

332 downloads

Not rated

GitHub

About

Integrates with major US news sources to analyze headline sentiment, providing normalized scores and source distribution for media trend insights.

Details

Author: fred-em
Repository: fred-em/headline-vibes
GitHub stars: 4
Downloads: 332
Categories: Web Scraping, Other, Developer Tools, Design, AI, Community, Media, Infrastructure, Frontend, Knowledge Base

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Headline Vibes

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /absolute/path/headline-vibes/build/index.mjs
Environment
- TRANSPORT stdio
- NEWS_API_KEY your-eventregistry-key
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

1. Install dependencies and build:

   npm install

   npm run build

2. Configure environment variables (stdio example):

   {

     "mcpServers": {

       "headline-vibes": {

         "command": "node",

         "args": ["/absolute/path/headline-vibes/build/index.mjs"],

         "env": {

           "NEWS_API_KEY": "your-eventregistry-key",

           "TRANSPORT": "stdio"

         }

       }

     }

   }

3. For HTTP (Railway) deployments, set TRANSPORT=http, HOST=0.0.0.0, PORT=<port>, and optionally ALLOWED_HOSTS/ALLOWED_ORIGINS.

1. Set environment variables (TRANSPORT, HOST, PORT, NEWS_API_KEY, optional ALLOWED_HOSTS, ALLOWED_ORIGINS, LOG_LEVEL).
2. Build once locally (npm run build) or via Railway’s build step.
3. Start with npm run start.
4. Health probe: GET /healthz returns 200 ok.

See docs/railway.md for the full playbook and docs/claude-desktop.md for Claude Desktop integration steps.

`analyze_headlines`

Daily 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_headlines`

Monthly aggregation between two months. Arguments: { 'startMonth': 'YYYY-MM', 'endMonth': 'YYYY-MM' }. Outputs per-month political sentiments, headline counts, and token/sampling diagnostics.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

Headline Vibes — EventRegistry MCP Server

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 MCPstructuredContent
- Built-in token budgeting and rate-limit telemetry

- Node.js v18+ (LTS recommended)
- EventRegistry API key (https://newsapi.ai)
- Install dependencies and build:

npm install npm run build

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

Daily sentiment snapshot for a single day. Arguments:{ "input": string }.

- Accepts natural language orYYYY-MM-DD.
- Returns investor/general scores, synopses, distributions, sample headlines, and diagnostics.

Monthly aggregation between two months. Arguments:{ "startMonth": "YYYY-MM", "endMonth": "YYYY-MM" }.

- Outputs per-month political sentiments, headline counts, and token/sampling diagnostics.

JSON schemas powering structured results live insrc/schemas/headlines.ts.

- Watch mode:npm run watch
- Stdio run:NEWS_API_KEY=... npm run start:stdio
- HTTP run:TRANSPORT=http HOST=0.0.0.0 PORT=8787 NEWS_API_KEY=... npm run start:http
- Smoke check EventRegistry connectivity:node ./build/scripts/smoke.mjs 2025-02-01
- Unit tests (Vitest):npm test
- Set environment variables (TRANSPORT,HOST,PORT,NEWS_API_KEY, optionalALLOWED_HOSTS,ALLOWED_ORIGINS,LOG_LEVEL).
- Build once locally (npm run build) or via Railway’s build step.
- Start withnpm run start.
- Health probe:GET /healthzreturns200 ok.

Seedocs/railway.mdfor the full playbook anddocs/claude-desktop.mdfor Claude Desktop integration steps.

Company intelligence in one tool call — funding, tech stack, employees, competitors, news from public APIs

Free trial available. Get 500MB test traffic upon registration, with integration completed in 5 minutes. We offer dynamic residential proxies, long-term ISP proxies and premium ISP proxies, covering over 200 countries and regions worldwide with more than 90 million residential IPs. Suitable for web crawling, cross-border multi-account management, SEO monitoring and other scenarios.

Web-intelligence API gateway: 17 APIs as 20 MCP tools for SEO and scraping. Pay-per-call via USDC.

Fetches the latest cryptocurrency news and converts article content from HTML to Markdown.

Search, trending, topics, and local news all in one MCP server. Article previews, deduplication, source filtering, and 40+ languages built in.

Fetches and caches daily articles from GeekNews using web scraping.

Access Google News and Google Trends data without paid APIs.

Fetches and parses stories from Hacker News, providing structured data for top, new, ask, show, and job posts.

Fetches horse racing news from the thoroughbreddailynews.com RSS feed.

Provides real-time hot trending topics from major Chinese social platforms and news sites.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

analyze_headlines

analyze_monthly_headlines

Claude Desktop / Cursor

Linux

Macos

Windows

Headline Vibes — EventRegistry MCP Server

Install

More like this

@mendableai/firecrawl Mcp Server

Sequential Thinking

Sentry

Github

Filesystem

EverArt

`analyze_headlines`

`analyze_monthly_headlines`