AllNewsAPI
БесплатноНе проверенEnables LLMs to search for news articles, get top headlines, and access comprehensive news data with advanced filtering options through AllNewsAPI.
Описание
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
Установить AllNewsAPI в Claude Desktop, Claude Code, Cursor
unyly install allnewsapi-mcpСтавит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.
Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh
Или настроить вручную
Выполни в терминале:
claude mcp add allnewsapi-mcp -- npx -y github:AllNewsAPI/mcp-serverFAQ
AllNewsAPI MCP бесплатный?
Да, AllNewsAPI MCP бесплатный — установка в пару кликов через Unyly без оплаты.
Нужен ли API-ключ для AllNewsAPI?
Нет, AllNewsAPI работает без API-ключей и переменных окружения.
AllNewsAPI — hosted или self-hosted?
Доступен hosted-вариант: Unyly запускает сервер в облаке, локальная установка не обязательна.
Как установить AllNewsAPI в Claude Desktop, Claude Code или Cursor?
Открой AllNewsAPI на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.
Похожие MCP
GitHub
PRs, issues, code search, CI status
автор: 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
автор: mcpdotdirectCompare AllNewsAPI with
Не уверен что выбрать?
Найди свой стек за 60 секунд
Автор?
Embed-бейдж для README
Похожее
Все в категории development
