GNews

Official2 toolsLive

by gnews-io · Python

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

io.github.gnews-io/gnews (GNews API) MCP Server

Official GNews API server that provides access to search news articles and retrieve top headlines. It targets a large news corpus, covering content from 80,000+ sources. The server is identified by the slug io-github-gnews-io-gnews.

🛠️ Key Features

Search news articles
Retrieve top headlines
Coverage from 80,000+ news sources

🚀 Use Cases

Query and browse relevant news articles
Fetch current top headlines across many sources

⚡ Developer Benefits

Uses the “Official GNews API server” scope for consistent news search and headline retrieval
Large source coverage (80,000+), supporting broad discovery

⚠️ Limitations

Only capabilities explicitly described here are search and top headlines; other functions (e.g., topics, tools, configuration) are not provided in the available data

Captured live from the server via tools/list.

search

Parameters9

q	string	required
lang	any	optional
country	any	optional
max	integer	optional
in_fields	any	optional
sortby	string	optional
date_from	any	optional
date_to	any	optional
page	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string"
    },
    "lang": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "country": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "max": {
      "default": 10,
      "type": "integer"
    },
    "in_fields": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "sortby": {
      "default": "publishedAt",
      "enum": [
        "publishedAt",
        "relevance"
      ],
      "type": "string"
    },
    "date_from": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "date_to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "page": {
      "default": 1,
      "type": "integer"
    }
  },
  "required": [
    "q"
  ],
  "additionalProperties": false
}

top_headlines

Parameters8

category	string	optional
lang	any	optional
country	any	optional
max	integer	optional
q	any	optional
date_from	any	optional
date_to	any	optional
page	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "category": {
      "default": "general",
      "enum": [
        "general",
        "world",
        "nation",
        "business",
        "technology",
        "entertainment",
        "sports",
        "science",
        "health"
      ],
      "type": "string"
    },
    "lang": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "country": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "max": {
      "default": 10,
      "type": "integer"
    },
    "q": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "date_from": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "date_to": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "page": {
      "default": 1,
      "type": "integer"
    }
  },
  "additionalProperties": false
}

README.md2 KBView on GitHub

📡 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:

bash

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:

json

{
  "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:

json

{
  "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.

Install

Tools (2)

searchtop_headlines

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.gnews.io/

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "gnews": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.gnews.io/"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.gnews-io/gnews (GNews API) MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search

top_headlines

📡 GNews API MCP Server

🔑 GNews API Key

🔗 MCP Integration

With Claude Code

🛠️ Available Tools

📄 Usage Examples

Search for articles

Get latest headlines

🔒 Security

📋 Client Prerequisites

Install

Remote endpoint

Related servers