# Gnews [Health: Active]

**Category:** 🔎 Search & Data Extraction  
**Repository:** https://github.com/pipeworx-io/mcp-gnews  
**GitHub Stars:** 0  
**npm Downloads (last month):** 824  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/gnews

## Description
GNews MCP — Global news search via GNews API (gnews.io)

## Tools
Capabilities this server exposes over MCP:

- **search_news** — Search global news articles by keyword (e.g., "climate change", "AI regulation"). Returns title, description, content snippet, source, and publication date. Supports language and country filters.
- **top_headlines** — Fetch current top news headlines from GNews (requires BYO API key). Optionally filter by category (general, world, nation, business, technology, entertainment, sports, science, health), country code, and language. Returns up to 100 articles with title, description, source, and publication date.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "gnews": {
    "command": "npx",
    "args": ["-y","@pipeworx/mcp-gnews"]
  }
}
```

## Documentation

## What the Gnews MCP server does

The Gnews MCP server gives MCP-compatible AI clients access to news data from GNews. It exposes two tools for different retrieval patterns:

- `search_news` finds articles that match a keyword or phrase, such as “climate change” or “AI regulation.” Results include the article title, description, content snippet, source, and publication date. Language and country filters can narrow the search.
- `top_headlines` retrieves current leading stories. It can filter by category, country code, and language, and returns up to 100 articles with title, description, source, and publication date. Supported categories include general, world, nation, business, technology, entertainment, sports, science, and health.

This makes the Gnews MCP server suitable for assistants that need current article discovery, topic monitoring, or a filtered headline feed.

## How it works

The hosted option uses a Pipeworx MCP endpoint. A client connects to `https://gateway.pipeworx.io/gnews/mcp`, where the GNews tools are listed along with shared Pipeworx gateway tools. The gateway also provides `ask_pipeworx`, which can route a natural-language request across the broader catalog. The full gateway is available at `https://gateway.pipeworx.io/mcp` when direct access to all listed packs is preferred.

The local option runs the package as an MCP server over stdin and stdout. It exposes only the Gnews tools and does not add the gateway’s shared meta-tools. Both connection methods use MCP operations such as `initialize`, `tools/list`, and `tools/call`.

## Setup and configuration

For a hosted connection, add the Gnews endpoint to an MCP client configuration. The README names Claude Desktop, Cursor, and Windsurf as supported client examples. For local use, configure the server with `npx -y @pipeworx/mcp-gnews`, or run that command directly to verify that it starts.

The local package does not require a Pipeworx account. Gateway HTTP calls may require your own GNews API key: anonymous calls to the documented HTTP tool endpoint pass the key as `_apiKey` alongside the tool arguments. The `top_headlines` tool specifically requires a bring-your-own API key.

## Tools and capabilities

The Gnews MCP server provides:

- Keyword-based article search
- Global news retrieval
- Language and country filtering for searches
- Current headline retrieval
- Category, country-code, and language filtering for headlines
- Results containing titles, descriptions, sources, dates, and—in searches—content snippets
- Up to 100 articles from the headlines tool

The gateway also exposes inspection and routing functions beyond these pack-specific tools, while the standalone package keeps the tool set limited to Gnews functionality.

## Limitations and notes

Results depend on the GNews API and its available coverage. The material does not specify retention, ranking, pagination, or full-article retrieval behavior. `top_headlines` requires a user-provided API key, and gateway HTTP access may also require one. Hosted pack connections currently include shared Pipeworx meta-tools; use the standalone package if you need only the two Gnews tools without those additions.

_Full upstream README: https://allmcps.com/mcp/gnews/readme_