# Newsapi

> Newsapi is a freemium MCP server for news and media. MCP server giving AI clients NewsAPI.org headlines and archive search via a Pipeworx. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/newsapi
- **Repository:** https://github.com/pipeworx-io/mcp-newsapi
- **MCP Registry name:** io.github.pipeworx-io/newsapi
- **Categories:** [news and media](https://ai-powered.com/categories/news-and-media)
- **Listing updated:** 2026-11-18

## About

The README describes this as a bridge to NewsAPI.org that exposes three news tools: current top headlines filterable by country, category, publisher or keyword, a search across an article archive with date and language filters, and a directory of publisher sources. Requests are routed through the Pipeworx gateway, which can be reached over a hosted streamable-http endpoint or run locally from npm as a stdio bridge.

Access is anonymous by default with a daily cap; the registry and README say a free Pipeworx key raises the limit and that calls are metered and billed through the gateway. The pack endpoint also lists shared gateway meta-tools such as ask_pipeworx alongside the three news tools, and the npm package can be configured to show only the news tools.

The listing is aimed at developers and agent builders who want news lookups inside Claude, Cursor, VS Code or a custom TypeScript app without managing their own NewsAPI key.

## Features

- **Top headlines lookup:** Fetches current headlines filterable by country, category, publisher source or keyword.
- **Archive keyword search:** Searches past articles by keyword, source domain, date range and language, sortable by relevancy, popularity or date.
- **Publisher source directory:** Lists NewsAPI publisher sources with ids that can be passed into the headline and search tools.
- **Hosted and local connection:** Available as a streamable-http remote endpoint or as an npm stdio package.
- **Natural-language routing:** The ask_pipeworx tool can answer plain-English questions by picking the right tool automatically.

## Good for

- Pulling technology or business headlines for a given country into an AI assistant
- Searching archived coverage of a company or topic across a date range
- Finding which news publishers cover a given category or language before filtering searches
- Building a news digest inside a TypeScript app via the Pipeworx SDK

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http newsapi https://gateway.pipeworx.io/newsapi/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/newsapi/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "newsapi": {
      "url": "https://gateway.pipeworx.io/newsapi/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "newsapi": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/newsapi/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "newsapi": {
      "serverUrl": "https://gateway.pipeworx.io/newsapi/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "newsapi": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/newsapi/mcp"
    }
  }
}
```

## Tools

- `top_headlines`: Current top headlines filterable by country, category, sources, or query.
- `everything`: Archive search across articles with date, language, domain and sort filters.
- `sources`: News publisher sources filterable by category, language and country.

## FAQ

### Does it need an API key?

No. Calls work anonymously with a daily cap; the registry says an optional Pipeworx API key raises that cap.

### How many tools does the endpoint list?

The README says the pack endpoint lists the three NewsAPI tools plus roughly 30 shared Pipeworx meta-tools, and the npm package can be limited to the news tools only.

### Which upstream service does it use?

It wraps NewsAPI.org, and the README states it is an independent, unofficial integration not endorsed by the provider.

### Is Newsapi free?

Newsapi has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Newsapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http newsapi https://gateway.pipeworx.io/newsapi/mcp

### What are the best alternatives to Newsapi?

The closest alternatives to Newsapi are World News Feeds, Crypto Feeds, Tech Feeds, Finance Feeds and Spaceflight News.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [World News Feeds](https://ai-powered.com/mcp/world-news-feeds): World News Feeds is a freemium MCP server for news and media.
- [Crypto Feeds](https://ai-powered.com/mcp/crypto-feeds): Crypto Feeds is a freemium MCP server for finance and payments.
- [Tech Feeds](https://ai-powered.com/mcp/tech-feeds): Tech Feeds is a freemium MCP server for news and media.
- [Finance Feeds](https://ai-powered.com/mcp/finance-feeds): Finance Feeds is a freemium MCP server for finance and payments.
- [Spaceflight News](https://ai-powered.com/mcp/spaceflight-news): Spaceflight News is a freemium MCP server for space data.
- [Science Feeds](https://ai-powered.com/mcp/science-feeds): Science Feeds is a freemium MCP server for news and media.
- [Us News Feeds](https://ai-powered.com/mcp/us-news-feeds): Us News Feeds is a freemium MCP server for news and media.
- [Gaming Feeds](https://ai-powered.com/mcp/gaming-feeds): Gaming Feeds is a freemium MCP server for news and media.

---
Source: https://ai-powered.com/mcp/newsapi
