English Français العربية

GNews

Official registry Search and web

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

Source code Website Documentation

What can you do with GNews?

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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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>'
JSON configuration (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

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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.

Frequently asked questions

What is GNews?

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

How do I install GNews?

It runs as a remote server. In 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>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does GNews need an API key?

Yes. It expects X-Api-Key, which you set in its configuration.

Is GNews open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains GNews?

It is published by gnews-io. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.