Log inSubmit server
AllNewsAPI logo

AllNewsAPI

Search live and historical news, retrieve filtered headlines, and monitor API quota through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install AllNewsAPI

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "allnewsapi": {
      "command": "npx",
      "args": [
        "-y",
        "allnewsapi-mcp@latest"
      ],
      "env": {
        "ALLNEWSAPI_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The AllNewsAPI MCP server connects MCP clients to real-time and historical news data from AllNewsAPI. It exposes tools for filtered article search, top headlines, and API usage checks, with optional sentiment and entity filters. Use it when an agent needs current or past news by topic, date, geography, language, category, publisher, or other supported criteria. It requires an AllNewsAPI key and can run locally through npx or remotely through a hosted MCP endpoint.

Use cases

  • Search historical coverage by keyword and date range
  • Retrieve top headlines for a country or category
  • Filter articles by sentiment or named entity
  • Check API limits and remaining quota

Key features

  • Live and historical news search
  • Filtered top headlines
  • Date, language, country, and category filters
  • AI sentiment and entity filtering
  • API plan and quota reporting
  • Hosted or local npx deployment

Tools3

What AllNewsAPI lets your agent do. Expand a tool for its parameters.

Self-reported~45 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

6/6 checks healthy over the last 41d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 16d ago via OSV.dev · allnewsapi-mcp@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1Stargazers on the source repository.
npm downloads260Package downloads in the last 30 days.
Last commit25d agoMost recent push to the default branch.
Tools exposed3Callable tools this server registers over MCP.

How AllNewsAPI works

What AllNewsAPI MCP server does

The AllNewsAPI MCP server gives MCP-compatible clients access to AllNewsAPI news data. It covers both current and historical articles, as well as top headlines from global sources. Agents can search by keyword, restrict results to a date range, request article content, and apply filters for language, country, region, category, publisher, or sorting.

The server also supports AI-analyzed filtering. Searches and headline requests can be narrowed by overall sentiment or by a named entity and entity type. Returned articles may include sentiment scores, detected entities, and a short AI-generated summary when those fields are available.

How it works

The server exposes three MCP tools:

  • search-news finds articles using a query and optional dates, filters, pagination, result count, keyword-matching attributes, and sort order.
  • headlines returns top headlines with optional country, category, language, sentiment, and entity filters.
  • usage reports the current plan, request limits, and remaining quota without requiring parameters.

Both article search and headline retrieval support up to 100 results per request, with a default of five. Search results can be ordered by publication time or relevance. Accepted country, language, category, and region values are defined in the AllNewsAPI documentation.

Setup and configuration

The AllNewsAPI MCP server can be used as a hosted remote server or launched locally. For hosted access, configure an MCP client with https://mcp.allnewsapi.com/mcp and provide the API key in the X-API-Key header. A query-string key is also supported, and bearer authentication is available as a fallback for clients that require it.

For a local setup, run npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE. The key can instead be supplied through the ALLNEWSAPI_KEY environment variable. This approach does not require cloning the repository or building the package. An API key is available from AllNewsAPI.

The server documentation includes setup paths for Claude Desktop, Cursor, VS Code, Windsurf, Claude Code, Claude Cowork, OpenWork, and other MCP clients.

Tools and capabilities

search-news accepts q, startDate, endDate, content, lang, country, region, category, max, page, attributes, sortby, publisher, ai_sentiment, ai_entity_name, and ai_entity_type. headlines accepts country, category, language, result count, sentiment, and entity filters. These options support workflows such as monitoring a company, finding regional coverage, or reviewing news from a defined period.

Limitations and notes

Advanced search filters including country, region, category, publisher, language, matching attributes, and sort order require a paid plan. Free-plan searches are limited to using q and max for the documented use case. API requests consume the account quota, which can be checked with usage. The project is licensed under MIT.

The AllNewsAPI MCP server does not describe a separate local database or article archive; it provides access through the AllNewsAPI service. Results and optional AI fields depend on the upstream API response and plan capabilities.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about AllNewsAPI

AllNewsAPI is an MCP server that connects MCP clients to AllNewsAPI's real-time and historical news data. Its main tools search articles with filters, retrieve top headlines, and report API plan and quota usage. An API key is required, and it can run locally with npx or through a hosted MCP endpoint.

Run `npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE` for a local setup. No repository clone or build step is required. You can also configure the hosted endpoint at `https://mcp.allnewsapi.com/mcp` and pass the key with the `X-API-Key` header or a supported alternative.

Yes, AllNewsAPI works with Cursor. Open Cursor Settings, select MCP, add a new MCP server, choose the command type, and use `npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE`.

Call the `usage` tool with no parameters. It reports your plan, request limits, and remaining quota.

Country, region, category, publisher, language, keyword-matching attributes, and sort order require a paid plan. On the free plan, use `search-news` with `q` and `max`.

Related MCP servers

All in Search & Data Extraction All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAllNewsAPI AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/allnewsapi?style=directory)](https://allmcps.com/mcp/allnewsapi)
HTML Embed
<a href="https://allmcps.com/mcp/allnewsapi"><img src="https://allmcps.com/api/badge/allnewsapi?style=directory" alt="AllNewsAPI on AllMCPs" /></a>