Newsnow

Provides access to Newsnow data via an MCP interface with multiple runtime options.

python

0

GitHub Stars

python

Language

6 months ago

First Indexed

3 months 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": {
    "bach-ai-tools-bachai-newsnow": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "env": {
        "API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

This MCP Server lets you access Newsnow data through a standardized MCP interface. It supports multiple runtime options so you can run it locally or via a managed platform, enabling you to query top news, category feeds, and location-specific results with a simple client.

How to use

You connect to this server from an MCP client and use its predefined endpoints to fetch Newsnow data. Choose a runtime that fits your setup: run via uvx for fast, zero-configuration startup; run directly with Python during development; or run the installed CLI for a lightweight, script-friendly approach.

How to install

Prerequisites: ensure you have Python installed if you plan to run the Python version. If you prefer the uvx option, you do not need to install uvx manually as it will manage itself.

Additional sections

Configuration and runtime are designed to be straightforward. You set your API key in an environment variable and then start the server using one of the provided commands.

Configuration

API authentication is required. Set your API key in the environment as follows:

Security

Keep your API key secure. Do not share it in client-side code or public repositories. Rotate keys if you suspect they’ve been exposed.

Troubleshooting

If you encounter connection issues, verify that the API key is correctly set in your environment and that you are using a supported runtime (uvx, Python, or the CLI). Check that the command you started remains running and that there are no port conflicts if you override defaults.

Available tools

top_news__pwered_by_google

Fetches top news powered by Google via the /newsv2_top_news endpoint.

top_news_by_locationpowered_by_google

Retrieves top news by location using the /newsv2_top_news_location endpoint.

top_news_by_site_powered_by_google

Gets top news by site with optional detailed fields via /newsv2_top_news_site.

news_api_v2_powered_by_google

Queries Newsnow with date ranges or time-bounded filters via /newsv2.

ping_test

Simple health check endpoint at GET /.

top_news_powered_by_duck_duck_go

Fetches top news via the DuckDuckGo-powered endpoint at /.

top_news_by_category_powered_by_google

Retrieves top news by category through /newsv2_top_news_cat.