Skip to main content
Glama
newspaper-mcp

newspaper-mcp

Official

newspaper-mcp

An MCP server that exposes newspaper4k's news article discovery and extraction capabilities as tools for LLM agents. Built with the official MCP Python SDK v2.

Tools

Tool

Description

parse_article

Download and parse a single article (title, authors, text, images, NLP).

parse_articles

Download and parse multiple article URLs concurrently.

discover_source

Crawl a news site's homepage for brand info, categories, feeds, articles.

list_source_articles

List article URLs/titles discovered on a source, with pagination.

search_news

Search Google News by keyword/topic/site/location (requires gnews).

extract_article_text

Fast text-only extraction from raw HTML or a URL, no metadata/NLP.

analyze_article

Download + run NLP: keywords with scores and an extractive summary.

get_source_categories

List a source's section/category URLs.

get_source_feeds

List a source's RSS/Atom feed URLs.

Related MCP server: News Aggregator MCP Server

Setup

This package depends on the local newspaper4k checkout at the repository root (via tool.uv.sources in pyproject.toml), so it always uses the in-development version of the library.

cd newspaper_mcp
uv sync

Run

uv run newspaper-mcp          # stdio transport (default)
uv run mcp dev src/newspaper_mcp/server.py   # MCP Inspector

To add it to an MCP host (e.g. Claude Code, Claude Desktop), point the host at uv run --directory /path/to/newspaper_mcp newspaper-mcp as a stdio server.

Notes

  • search_news requires the optional gnews package, already pulled in via the newspaper4k[gnews] extra declared in pyproject.toml.

  • NLP features (nlp(), keyword extraction, summarization) require nltk, pulled in via the newspaper4k[nlp] extra. On first use, nltk may need to download its punkt tokenizer data.

  • All tools perform live network requests to the target news sites; there is no caching between calls.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Get access to real-time and historical news data including top headlines from global sources via AllNewsAPI. Supports multiple filter options including keyword search, category, language and more
      3
      78 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables agents to discover feeds for a site, retrieve dated feed items as clean JSON, and perform keyless news searches across Google News and Bing News with deduplication and publisher attribution.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to search and monitor news coverage, fetch article metadata, explore curated source packs, and save links to hamir with notes.
      1
      MIT