Command Palette

Search for a command to run...

UnylyUnyly
Browse all

AllNewsAPI

FreeNot checked

Enables LLMs to search for news articles, get top headlines, and access comprehensive news data with advanced filtering options through AllNewsAPI.

GitHubEmbed

About

Enables LLMs to search for news articles, get top headlines, and access comprehensive news data with advanced filtering options through AllNewsAPI.

README

A Model Context Protocol (MCP) server that provides news data capabilities using AllNewsAPI. This server enables LLMs to search for news articles, get top headlines, and access comprehensive news data with advanced filtering options.

Key Features

  • Comprehensive news search. Access news articles with advanced filtering by date, language, country, category, and more.
  • Real-time headlines. Get the latest top headlines from around the world with customizable parameters.
  • LLM-optimized responses. Clean, formatted output designed for easy consumption by language models.

Requirements

  • Node.js 18 or newer
  • AllNewsAPI key (get one at allnewsapi.com)
  • VS Code, Cursor, Windsurf, Claude Desktop, or any other MCP client

Getting started

First, get your API key from AllNewsAPI and install the AllNewsAPI MCP server with your client.

Standard config works in most of the tools:

{
  "mcpServers": {
    "allnewsapi": {
      "command": "npx",
      "args": [
        "allnewsapi-mcp@latest",
        "--apikey",
        "YOUR_API_KEY_HERE"
      ]
    }
  }
}
Claude Desktop

Follow the MCP install guide, use the standard config above, or configure with environment variable:

{
  "mcpServers": {
    "allnewsapi": {
      "command": "npx",
      "args": ["allnewsapi-mcp@latest"],
      "env": {
        "ALLNEWSAPI_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}
Cursor

Go to Cursor Settings -> MCP -> Add new MCP Server. Name it "AllNewsAPI", use command type with the command npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE. You can also verify config or add command arguments via clicking Edit.

VS Code

Follow the MCP install guide, use the standard config above. You can also install the AllNewsAPI MCP server using the VS Code CLI:

# For VS Code
code --add-mcp '{"name":"allnewsapi","command":"npx","args":["allnewsapi-mcp@latest","--apikey","YOUR_API_KEY_HERE"]}'

After installation, the AllNewsAPI MCP server will be available for use with your GitHub Copilot agent in VS Code.

Windsurf

Follow Windsurf MCP documentation. Use the standard config above.

Configuration

The AllNewsAPI MCP server supports the following configuration options:

API Key Configuration

You can provide your AllNewsAPI key in two ways:

  1. Command-line argument (recommended for most setups):
npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE
  1. Environment variable:
export ALLNEWSAPI_KEY=YOUR_API_KEY_HERE
npx allnewsapi-mcp@latest

Local Installation

If you want to install and run the server locally:

# Clone the repository
git clone https://github.com/AllNewsAPI/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Run the server
node build/index.js --apikey YOUR_API_KEY_HERE

Tools

News search and headlines
  • search-news

    • Title: Search news articles
    • Description: Search for news articles using various parameters including keywords, date ranges, and filters
    • Parameters:
      • q (string, optional): Keywords to search for in news articles
      • startDate (string, optional): Filter articles published on or after this date (YYYY-MM-DD format)
      • endDate (string, optional): Filter articles published on or before this date (YYYY-MM-DD format)
      • content (boolean, optional): Whether to retrieve full article content (default: false)
      • lang (string, optional): Language code(s) of the articles (e.g., 'en', 'fr', 'de')
      • country (string, optional): Country code(s) of publication (e.g., 'us', 'gb', 'ca')
      • region (string, optional): Region(s) to filter by (e.g., 'americas', 'europe', 'asia')
      • category (string, optional): Category/categories to filter by (e.g., 'business', 'technology', 'sports')
      • max (number, optional): Number of articles to return, 1-100 (default: 5)
      • attributes (string, optional): Where to search for keywords: 'title', 'description', 'content' (default: 'title,description')
      • page (number, optional): Page number for pagination (default: 1)
      • sortby (string, optional): Sort results by 'publishedAt' or 'relevance' (default: 'publishedAt')
      • publisher (string, optional): Filter by specific publisher(s)
    • Read-only: true
  • headlines

    • Title: Get top headlines
    • Description: Get top headlines with optional filtering by country, category, and language
    • Parameters:
      • country (string, optional): Country code(s) of publication (e.g., 'us', 'gb', 'ca')
      • category (string, optional): Category to filter by (e.g., 'business', 'technology', 'sports')
      • max (number, optional): Number of articles to return, 1-100 (default: 5)
      • lang (string, optional): Language code of the articles (e.g., 'en', 'fr', 'de')
    • Read-only: true

Supported Parameters

Languages

The following language codes are supported: ar, zh, nl, en, fr, de, el, he, hi, it, ja, ml, mr, no, pt, ro, ru, es, sv, ta, te, uk

Categories

The following categories are supported: adult, autos, beauty, business, communities, crime, cryptocurrency, electronics, entertainment, finance, food, games, health, hobbies, lifestyle, internet, jobs, law, literature, pets, politics, realty, science, sensitive, shopping, society, sports, technology, travel

Regions

The following regions are supported: africa, americas, antarctic, asia, europe, oceania

Countries

The API supports numerous country codes including:

  • us (United States)
  • gb (United Kingdom)
  • ca (Canada)
  • au (Australia)
  • de (Germany)
  • fr (France)
  • jp (Japan)
  • in (India)
  • And many more...

The server validates all country codes against the official list from AllNewsAPI.

Example Usage

Once you have connected your MCP client to the AllNewsAPI server, you can ask natural language queries like:

  • "Get me the latest technology news from the US"
  • "Find news articles about climate change from European sources"
  • "Show me top business headlines from the past week"
  • "Search for cryptocurrency news in English from the last month"
  • "Get sports headlines from Canada and Australia"

The server will validate all parameters, connect to the AllNewsAPI, and return formatted results that are easy to read and understand.

Error Handling

The server includes comprehensive error handling:

  • API Key validation: Clear error messages if no API key is provided
  • Parameter validation: All parameters are validated against official AllNewsAPI supported values
  • Network error handling: Graceful handling of API connection issues
  • Rate limit handling: Proper error messages for API rate limits

Technical Implementation

The server is built with TypeScript and the Model Context Protocol SDK. Key features include:

  • ES module support with top-level await
  • Comprehensive error handling with informative messages
  • Parameter validation against official supported values
  • Clean formatting of API responses for LLM consumption
  • Flexible configuration supporting multiple API key methods

from github.com/AllNewsAPI/mcp-server

Install AllNewsAPI in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install allnewsapi-mcp

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add allnewsapi-mcp -- npx -y github:AllNewsAPI/mcp-server

FAQ

Is AllNewsAPI MCP free?

Yes, AllNewsAPI MCP is free — one-click install via Unyly at no cost.

Does AllNewsAPI need an API key?

No, AllNewsAPI runs without API keys or environment variables.

Is AllNewsAPI hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install AllNewsAPI in Claude Desktop, Claude Code or Cursor?

Open AllNewsAPI on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare AllNewsAPI with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs