AllNewsAPI
FreeNot checkedEnables LLMs to search for news articles, get top headlines, and access comprehensive news data with advanced filtering options through AllNewsAPI.
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:
- Command-line argument (recommended for most setups):
npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE
- 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 articlesstartDate(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
Install AllNewsAPI in Claude Desktop, Claude Code & Cursor
unyly install allnewsapi-mcpInstalls 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-serverFAQ
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
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectCompare AllNewsAPI with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs
