English Français العربية

GNews

Registre officiel Recherche et web

Official GNews API server: search news articles and top headlines from 80,000+ sources.

Code source Site web Documentation

Que pouvez-vous faire avec GNews ?

  • search: Search for news articles through a combination of keywords.
  • top_headlines: Get top headlines by category and country.

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http gnews 'https://mcp.gnews.io/' --header 'X-Api-Key: <Your GNews API key. Get a free key at https://gnews.io/register>'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "gnews": {
            "type": "http",
            "url": "https://mcp.gnews.io/",
            "headers": {
                "X-Api-Key": "<Your GNews API key. Get a free key at https://gnews.io/register>"
            }
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. 📡 GNews API MCP Server
  2. 🔑 GNews API Key
  3. 🔗 MCP Integration
  4. 🛠️ Available Tools
  5. 📄 Usage Examples
  6. 🔒 Security
  7. 📋 Client Prerequisites

📡 GNews API MCP Server

This document describes a Model Context Protocol (MCP) server that exposes the GNews API.

This server is already deployed and publicly accessible, so you don't need to install anything. You just need to connect it to your compatible MCP client (Claude Code, Gemini CLI, etc.).

🔑 GNews API Key

To use this server, you need a valid GNews API key.

👉 Get your API key here

The API key must be provided in the following way:

  • Via an HTTP header X-Api-Key

🔗 MCP Integration

This server is listed in the official MCP Registry as io.github.gnews-io/gnews.

With Claude Code

Add the server to your Claude Code configuration with the following command:

claude mcp add --transport http gnews_api https://mcp.gnews.io/ --header "X-Api-Key: YOUR_API_KEY"

🛠️ Available Tools

Once the server is connected, the following two tools are available:

  • search: Search for news articles through a combination of keywords.
  • top_headlines: Get top headlines by category and country.

📄 Usage Examples

Search for articles

This example searches for the 5 latest English articles on climate change:

{
  "tool": "search",
  "args": {
    "q": "climate change",
    "lang": "en",
    "max": 5
  }
}
Get latest headlines

This example retrieves the 5 top headlines from the "technology" category in the United States:

{
  "tool": "top_headlines",
  "args": {
    "category": "technology",
    "country": "us",
    "max": 5
  }
}

🔒 Security

  • Never share your API key. Treat it like a password.
  • This server acts as a proxy: it does not store any API keys. Your key is transmitted directly to GNews API with each request.
  • Always use an HTTPS connection to communicate with the server to ensure your key is encrypted in transit.
  • The hosted server records anonymous usage statistics for each tool call: tool name, MCP client name and version, success or error, duration, and the lang, country, category, max, page and sortby parameters. Your API key is only recorded as a one-way hash, and your search queries are never recorded.

📋 Client Prerequisites

  • A compatible MCP client (e.g., Claude Code).
  • The latest version of Gemini CLI is recommended for optimal compatibility.

Questions fréquentes

Qu'est-ce que GNews ?

Official GNews API server: search news articles and top headlines from 80,000+ sources.

Comment installer GNews ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http gnews 'https://mcp.gnews.io/' --header 'X-Api-Key: <Your GNews API key. Get a free key at https://gnews.io/register>'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour GNews ?

Oui. Il attend X-Api-Key, à renseigner dans sa configuration.

GNews est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient GNews ?

Il est publié par gnews-io. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.