Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
NewsAPI MCP Server
A Model Context Protocol (MCP) server that provides news search and headline retrieval using NewsAPI. Get top headlines by country and category, or search articles across thousands of sources.
[View on mpak registry](https://mpak.dev/packages/@nimblebraininc/newsapi?utm_source=github&utm_medium=readme&utm_campaign=mcp-newsapi) | Built by [NimbleBrain](https://nimblebrain.ai?utm_source=github&utm_medium=readme&utm_campaign=mcp-newsapi)
Install
Install with mpak:
mpak install @nimblebraininc/newsapiConfiguration
Get your API key from NewsAPI, then configure:
mpak config set @nimblebraininc/newsapi api_key YOUR_API_KEYClaude Code
claude mcp add newsapi -- mpak run @nimblebraininc/newsapiClaude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"newsapi": {
"command": "mpak",
"args": ["run", "@nimblebraininc/newsapi"]
}
}
}See the mpak registry page for full install options.
Tools
get_top_headlines
Get top news headlines by country and category.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | No | Keywords to search in article headlines |
country | string | No | 2-letter country code (default: "us") |
category | string | No | One of: "business", "entertainment", "general", "health", "science", "sports", "technology" |
page_size | integer | No | Number of results, max 100 (default: 10) |
Example call:
{
"name": "get_top_headlines",
"arguments": {
"country": "us",
"category": "technology",
"page_size": 5
}
}Example response:
{
"articles": [
{
"title": "New AI breakthrough announced",
"description": "Researchers have developed a new approach...",
"url": "https://example.com/article",
"source": "TechCrunch",
"author": "Jane Smith",
"published_at": "2026-02-13T10:00:00Z"
}
],
"total_results": 5
}search_news
Search news articles across all sources. Note: Only returns articles from the last 30 days (NewsAPI free tier limitation).
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search keywords or phrase |
sources | string | No | Comma-separated source IDs (e.g. "bbc-news,cnn") |
domains | string | No | Comma-separated domains (e.g. "bbc.co.uk,techcrunch.com") |
from_date | string | No | Oldest article date, ISO 8601 (e.g. "2026-01-01") |
to_date | string | No | Newest article date, ISO 8601 (e.g. "2026-01-31") |
language | string | No | 2-letter language code (default: "en") |
sort_by | string | No | "relevancy", "popularity", or "publishedAt" (default: "publishedAt") |
page_size | integer | No | Number of results, max 100 (default: 10) |
Example call:
{
"name": "search_news",
"arguments": {
"query": "artificial intelligence",
"sort_by": "relevancy",
"page_size": 5
}
}Example response:
{
"query": "artificial intelligence",
"articles": [
{
"title": "The State of AI in 2026",
"description": "A comprehensive look at how AI has evolved...",
"url": "https://example.com/ai-2026",
"source": "Wired",
"author": "John Doe",
"published_at": "2026-02-10T14:30:00Z",
"content": "First 200 characters of the article content..."
}
],
"total_results": 127
}Quick Start
Local Development
git clone https://github.com/NimbleBrainInc/mcp-newsapi.git
cd mcp-newsapi
# Install dependencies
uv sync
# Set API key
cp .env.example .env
# Edit .env with your API key
# Run the server (stdio mode)
uv run python -m mcp_newsapi.serverThe server supports HTTP transport with:
- Health check:
GET /health - MCP endpoint:
POST /mcp
Development
# Install with dev dependencies
uv sync --group dev
# Run all checks (format, lint, typecheck, unit tests)
make check
# Run unit tests
make test
# Run with coverage
make test-covAbout
NewsAPI MCP Server is published on the mpak registry and built by NimbleBrain. mpak is an open registry for Model Context Protocol servers.
License
MIT