news

This MCP server provides access to up-to-date news data sourced from newsdata.io. It is designed to fetch the latest headlines, trending stories, and related metadata using the configured News API. The server exposes prompts that you can use to retrieve current news by region, language, topic, or other facets supported by News Data's API. Typical usage includes requesting the latest headlines from a specific country, top news from a particular topic, or sources for a given region. The included prompts demonstrate common queries such as latest US headlines, top Nepal headlines in Nepali, Bhutan sources, and individual topics like Lionel Messi or crypto news. You can customize the prompts to fit your application’s needs or extend them with additional filters supported by the underlying API.

Prerequisites:

• Node.js installed on your system (version compatible with your MCP server setup)
• Access to a News Data API key (NEWS_API_KEY)
• Network access to reach newsdata.io endpoints

1. Clone the repository: git clone <your-repo-url> cd <repository-directory>

2. Install dependencies (assuming package.json exists): npm install

3. Set up environment variables (example):

   • Create a .env file or export variables in your shell
   • NEWS_API_KEY=your_news_data_api_key
   • NEWS_BASE_URL=https://newsdata.io

4. Start the MCP server using Node.js (as configured in mcp_config):

   • Ensure the built dist/index.js exists if you’re using a prebuilt distribution
   • Run your command as configured (example): node location_to_your_dist/index.js

5. Verify the server is running by sending a test prompt and checking the response.

Tips and common considerations:

• Ensure NEWS_API_KEY is valid and has access to the necessary endpoints on newsdata.io.
• If you switch from local node path to using npx, replace the command and args accordingly; for npx usage, command would be something like 'path_to_your_npx' and args would include 'news-mcp-server'.
• If you encounter REST or API rate limit errors, consider implementing caching on your consumer side or adjusting request cadence.
• The NEWS_BASE_URL can be customized if you’re using a regional mirror or a different API endpoint; keep it consistent with your API key’s allowances.
• Monitor environment variables and secret management practices to avoid leaking API keys in logs or code repositories.