news-mcp-server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
news-mcp-server
A FastAPI-based MCP server that exposes NewsAPI.org as structured tools via fastapi-mcp.
Endpoints / MCP Tools
Route | Operation ID (MCP tool name) | Description |
|
| Top headlines filtered by country, category, or source |
|
| Full-text article search with date range and sort options |
|
| Most-read stories right now, filtered by language |
|
| Browse available publishers by category, language, country |
Related MCP server: gnews-mcp-server
Setup
1. Get a NewsAPI key
Sign up at https://newsapi.org/register and copy your API key.
2. Configure environment
cp .env.example .env
# Edit .env and set NEWS_API_KEY=your_key_here3. Install dependencies
pip install -e ".[dev]"4. Run the server
uvicorn news_mcp.main:app --reload
# or
news-mcpThe server starts on http://localhost:8000.
Swagger UI:
http://localhost:8000/docsMCP endpoint:
http://localhost:8000/mcp(auto-mounted by fastapi-mcp)
Use with Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"news": {
"command": "uvicorn",
"args": ["news_mcp.main:app", "--port", "8000"],
"env": {
"NEWS_API_KEY": "your_key_here"
}
}
}
}Running tests
pytestTests mock all NewsAPI HTTP calls — no real network traffic or API key required.
Project structure
src/news_mcp/
├── main.py # App factory, MCP mount
├── config.py # pydantic-settings config
├── models/
│ └── schemas.py # All Pydantic request/response models
├── services/
│ └── news_service.py # NewsAPI HTTP logic
└── routes/
├── headlines.py
├── search.py
├── trending.py
└── sources.py
tests/
├── conftest.py
├── test_headlines.py
├── test_search.py
├── test_trending.py
└── test_sources.pyTool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Unofficial Mediastack MCP — wraps Mediastack API (api.mediastack.com/v1)
NewsData.io MCP — wraps the NewsData.io global news API (newsdata.io)
Google News headlines, sources, and links via the Apify Google News API, hosted MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA FastAPI application that hosts multiple MCP servers for weather, news, currency, and quotes APIs.3MIT
- FlicenseNot gradedqualityDmaintenanceMCP server providing access to the GNews API for fetching news articles and headlines. Supports search and top headlines with advanced filtering by language, country, category, and date.1-
- AlicenseNot gradedqualityBmaintenanceA Model Context Protocol (MCP) server that provides real-time news intelligence using NewsAPI.ai. This server enables LLMs to search articles, track events, and analyze news through natural conversation.598 npm3MIT
- AlicenseBqualityDmaintenanceA Model Context Protocol (MCP) server that provides access to global news articles through the News API. It implements a standardized interface for searching news articles, retrieving top headlines, and listing available news sources.312MIT