News Api14

Provides access to News Api14 data via MCP, exposing article search, content retrieval, and trending data.

python

0

GitHub Stars

python

Language

5 months ago

First Indexed

2 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-news-api14": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "env": {
        "API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

You can access the News Api14 API through a dedicated MCP Server that runs locally or via tooling, enabling you to integrate news data safely and efficiently into your applications with minimal setup.

How to use

You will run an MCP client that connects to the bach-news_api14 server using a stdio-based workflow. Start by ensuring your API key is available in your environment, then launch the MCP client with the provided command sequence. Once running, you can query the server for publishers, articles, and topics, and integrate results into your app with simple function calls as you would for any API connection.

How to install

Prerequisites: you need Python and pip, and you will use the uvx helper or a direct Python invocation to run the server.

Step by step commands you should run in your environment:

# Install the MCP package from PyPI
pip install bach-news_api14

# Run with uvx (recommended, auto-installs and runs)
uvx --from bach-news_api14 bach_news_api14

# Or run directly (development mode)
python server.py

# After installation, you can also run as a command if preferred
bach_news_api14

Configuration and usage notes

API access requires authentication. Set your API key in the environment to authorize requests.

Environment variables to configure and use include:

API_KEY: Your API key (required)

Example MCP connection configuration

{
  "mcpServers": {
    "bach-news_api14": {
      "command": "uvx",
      "args": ["--from", "bach-news_api14", "bach_news_api14"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

Available tools and endpoints

This server provides a set of endpoints to search publishers, fetch article content, search articles, obtain random articles, retrieve trending topics, and list supported countries, languages, and topics.

Available tools

search_publishers

Retrieve a list of publishers with details such as descriptions, logos, languages, categories, and social links. Endpoint: GET /v2/search/publishers

get_article_content

Fetch comprehensive metadata and content for a specific article. Endpoint: GET /v2/article

search_articles

Find articles by keywords with filters for country, language, publisher, and date. Endpoint: GET /v2/search/articles

get_random_article

Obtain a randomly selected article, with optional filters for country and language. Endpoint: GET /v2/article/random

trending_topics

Find the most popular news articles for a given country, language, and topic. Endpoint: GET /v2/trendings

supported_countries

List of supported countries and their languages. Endpoint: GET /v2/info/countries

supported_languages

List of supported languages. Endpoint: GET /v2/info/languages

supported_topics

Information about supported topics, with access depending on subscription. Endpoint: GET /v2/info/topics