AllNewsAPI/mcp-server

FreeMaintained

Get access to real-time and historical news data including top headlines from global sources via AllNewsAPI.

by AllNewsAPI

GitHub Embed

About

Get access to real-time and historical news data including top headlines from global sources via AllNewsAPI.

README

npm AllNewsAPI/mcp-server MCP server

AllNewsAPI/mcp-server MCP server

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. This Model Context Protocol server lets MCP clients (Claude, Cursor, VS Code, Windsurf, and others) search news articles, fetch top headlines, and check your API usage.

You'll need an API key — get one at allnewsapi.com.

Quick start

Pick one of the two ways to connect.

Hosted (no install)

Point your client at the hosted server and pass your API key in the X-API-Key header:

{
  "mcpServers": {
    "allnewsapi": {
      "type": "remote",
      "url": "https://mcp.allnewsapi.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Prefer a URL-only setup? Use https://mcp.allnewsapi.com/mcp?apikey=YOUR_API_KEY_HERE instead of the header.

The key can be supplied three ways, in this order of precedence: the X-API-Key header, the apikey query parameter, or an Authorization: Bearer YOUR_API_KEY_HERE header (a fallback for clients that only support bearer tokens).

Local (npx)

Runs the server on your machine via npx — no clone or build needed:

{
  "mcpServers": {
    "allnewsapi": {
      "command": "npx",
      "args": ["allnewsapi-mcp@latest", "--apikey", "YOUR_API_KEY_HERE"]
    }
  }
}

You can also supply the key as an ALLNEWSAPI_KEY environment variable instead of --apikey.

Client-specific setup

Claude Desktop

Edit your config (Settings → Developer → Edit Config) and add the local or hosted snippet above. Full guide: modelcontextprotocol.io/quickstart/user.

Cursor

Cursor Settings → MCP → Add new MCP Server. Name it "AllNewsAPI", choose the command type, and enter:

npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE

VS Code

code --add-mcp '{"name":"allnewsapi","command":"npx","args":["allnewsapi-mcp@latest","--apikey","YOUR_API_KEY_HERE"]}'

The server is then available to your GitHub Copilot agent. Full guide: VS Code MCP docs.

Windsurf

Add the local or hosted snippet above to your MCP config. Full guide: Windsurf MCP docs.

Claude Code

Add it from the terminal — local:

claude mcp add allnewsapi -- npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE

Or the hosted server:

claude mcp add --transport http allnewsapi https://mcp.allnewsapi.com/mcp --header "X-API-Key: YOUR_API_KEY_HERE"

Claude Cowork

Cowork runs inside Claude Desktop. Add the hosted server as a custom connector — Customize → Connectors → + — and enter the URL with your key:

https://mcp.allnewsapi.com/mcp?apikey=YOUR_API_KEY_HERE

For a local setup, use the Claude Desktop config shown above.

OpenWork

OpenWork is an open-source Cowork alternative with MCP support. Add AllNewsAPI using either the local command (npx allnewsapi-mcp@latest --apikey YOUR_API_KEY_HERE) or the hosted URL above, following OpenWork's MCP configuration.

Any other MCP client: point it at the hosted URL (https://mcp.allnewsapi.com/mcp) or run the npx allnewsapi-mcp@latest command with your API key.

Tools

`search-news`

Search articles by keyword, date, and filters.

Parameter	Type	Description
`q`	string	Keywords to search for
`startDate` / `endDate`	string	Date range (`YYYY-MM-DD`)
`content`	boolean	Include full article content (default: false)
`lang`	string	Language code(s), e.g. `en`, `fr`
`country`	string	Country code(s), e.g. `us`, `gb`
`region`	string	Region(s), e.g. `americas`, `europe`
`category`	string	Category/categories, e.g. `business`
`max`	number	Number of articles, 1–100 (default: 5)
`page`	number	Page number (default: 1)
`attributes`	string	Where to match keywords: `title`, `description`, `content`
`sortby`	string	`publishedAt` or `relevance`
`publisher`	string	Filter by publisher(s)
`ai_sentiment`	string	`positive`, `negative`, or `neutral`
`ai_entity_name`	string	Named entity, e.g. `Apple`
`ai_entity_type`	string	Entity type, e.g. `person`, `organization`, `location`

`headlines`

Get top headlines, optionally filtered.

Parameter	Type	Description
`country`	string	Country code(s), e.g. `us`, `gb`
`category`	string	Category, e.g. `technology`
`lang`	string	Language code, e.g. `en`
`max`	number	Number of articles, 1–100 (default: 5)
`ai_sentiment`	string	`positive`, `negative`, or `neutral`
`ai_entity_name`	string	Named entity, e.g. `Apple`
`ai_entity_type`	string	Entity type, e.g. `person`, `organization`, `location`

`usage`

Check your plan, request limits, and remaining quota. No parameters.

Plan note: Advanced filters — country, region, category, publisher, lang, attributes, and sortby — require a paid plan. On the free plan, use search-news with q and max. See pricing.

AI filtering

search-news and headlines accept AI-analyzed filters:

ai_sentiment — overall article sentiment (positive, negative, neutral)
ai_entity_name — a named entity in the article (e.g. United Nations)
ai_entity_type — entity category (person, organization, location)

Returned articles may also include AI sentiment scores, detected entities, and a short AI summary when available.

Example prompts

"Get me the latest technology news from the US"
"Find articles about climate change from European sources"
"Show me top business headlines from the past week"
"Find positive news about renewable energy"
"Show me articles mentioning Apple as an organization"
"Check my API usage and remaining quota"

Supported values

Full lists of accepted values live in the AllNewsAPI docs:

License

MIT © AllNewsAPI — see LICENSE for details.

from github.com/AllNewsAPI/mcp-server

Installing AllNewsAPI/mcp-server

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/AllNewsAPI/mcp-server

FAQ

Is AllNewsAPI/mcp-server MCP free?

Yes, AllNewsAPI/mcp-server MCP is free — one-click install via Unyly at no cost.

Does AllNewsAPI/mcp-server need an API key?

No, AllNewsAPI/mcp-server runs without API keys or environment variables.

Is AllNewsAPI/mcp-server hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install AllNewsAPI/mcp-server in Claude Desktop, Claude Code or Cursor?

Open AllNewsAPI/mcp-server on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

GitHub

PRs, issues, code search, CI status

by GitHub

Filesystem

Secure file operations with configurable access controls.

by Community

Memory

Knowledge graph-based persistent memory system.

by Community

Template MCP Server

A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure

by mcpdotdirect

Amap Maps Mcp Server

MCP server for using the AMap Maps API

by duxiaohui

Supabase

Database, auth and storage

by Supabase

Everything

Reference / test server with prompts, resources, and tools.

by Community

Git

Tools to read, search, and manipulate Git repositories.

by Community

Sequential Thinking

Dynamic and reflective problem-solving through thought sequences.

by Community

Time

Time and timezone conversion capabilities.

by Community

Compare AllNewsAPI/mcp-server with

AllNewsAPI/mcp-servervsGitHub AllNewsAPI/mcp-servervsFilesystem AllNewsAPI/mcp-servervsMemory AllNewsAPI/mcp-servervsTemplate MCP Server AllNewsAPI/mcp-servervsAmap Maps Mcp Server AllNewsAPI/mcp-servervsSupabase AllNewsAPI/mcp-servervsEverything AllNewsAPI/mcp-servervsGit AllNewsAPI/mcp-servervsSequential Thinking AllNewsAPI/mcp-servervsTime

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs

Command Palette

AllNewsAPI/mcp-server

About

README

Quick start

Hosted (no install)

Local (npx)

Client-specific setup

Tools

search-news

headlines

usage

AI filtering

Example prompts

Supported values

License

Installing AllNewsAPI/mcp-server

FAQ

Is AllNewsAPI/mcp-server MCP free?

Does AllNewsAPI/mcp-server need an API key?

Is AllNewsAPI/mcp-server hosted or self-hosted?

How do I install AllNewsAPI/mcp-server in Claude Desktop, Claude Code or Cursor?

Related MCPs

GitHub

Filesystem

Memory

Template MCP Server

Amap Maps Mcp Server

Supabase

Everything

Git

Sequential Thinking

Time

Compare AllNewsAPI/mcp-server with

`search-news`

`headlines`

`usage`