# NewsAPI MCP

> NewsAPI provides immediate access to global news feeds, letting your agent search articles from over 150,000 sources worldwide. Get live breaking news, track market sentiment across different countries, or perform deep historical research by querying five years of archived headlines and full-text reports.

## Overview
- **Category:** artificial-intelligence
- **Price:** Free
- **Tags:** news-aggregation, content-search, real-time-data, headlines, media-monitoring

## Description

This MCP connects your AI client to a massive global archive of journalism. It's built for anyone who needs more than just Google News—it lets you programmatically monitor what’s happening everywhere, all the time. You can pull top local headlines by country or restrict searches to specific industry domains. Need to track how frequently a brand is mentioned in major outlets? Use this MCP to build that monitoring stream directly into your agent's workflow.

The Vinkius catalog hosts this resource because it turns messy, disparate data streams into actionable information. You can search everything published—not just the front page headlines—using filters for language, date range, or even source name. It’s pure research power: query articles from five years ago to spot trends, or get real-time feeds for breaking stories instantly.

## Tools

### get_headlines_by_category
Retrieves the top breaking headlines based on a specific topic category (e.g., business, sports).

### get_headlines_by_country
Pulls the most important breaking news stories for a specified country code.

### get_articles_from_domains
Searches for articles published only by specific websites or domains you name.

### get_articles_by_language
Filters article searches to include content written in a particular language code.

### get_popular_articles
Finds the most frequently read and popular articles globally.

### get_recent_articles
Retrieves a list of the absolute newest articles published, regardless of topic or popularity.

### get_headlines_by_source
Gets top headlines specifically from one or more named news organizations (like CNN).

### list_sources
Provides a complete list of all the news publishers and sources indexed by the service.

### search_articles
Executes a broad search across all available articles, allowing you to define keywords and filters.

### search_headlines
Searches for specific topics or keywords within headline summaries only.

## Prompt Examples

**Prompt:** 
```
Show me top business headlines in the US.
```

**Response:** 
```
Top US Business Headlines: 1. Fed Holds Rates Steady Amid Inflation Concerns (Reuters). 2. Tech Stocks Rally as Earnings Beat Expectations (Bloomberg). 3. Oil Prices Surge on Supply Disruptions (CNBC).
```

**Prompt:** 
```
Search for articles about 'Artificial Intelligence regulation' from the last 30 days.
```

**Response:** 
```
Found 1,245 articles: 1. EU AI Act Enters Final Review Phase (TechCrunch). 2. US Senate Debates New AI Safety Framework (The Verge). 3. UK Proposes Light-Touch AI Regulation (Financial Times).
```

**Prompt:** 
```
What are the main news sources in Brazil?
```

**Response:** 
```
Top Brazil Sources: Globo, Folha de S.Paulo, O Estado de S. Paulo, UOL, CNN Brasil, Metrópoles, and Valor Econômico. Total: 35+ active Brazilian sources indexed.
```

## Capabilities

### Search entire historical archives
Use this MCP's search tools to find every article ever published on a topic, allowing you to filter results by date range, language, and specific source domain.

### Monitor real-time global trends
Fetch live top headlines for any given country or category instantly, helping your agent track breaking events as they happen across the globe.

### Identify content sources and metadata
List all available news publishers and retrieve top articles from specific sources (like 'bbc-news' or 'cnn') to build a complete map of where information lives.

## Use Cases

### Tracking a competitor's PR fallout
A brand manager needs to know if a key rival is getting negative press. The agent uses `get_headlines_by_source` combined with keyword searches via `search_articles` to aggregate all mentions from specific competing outlets over the last month.

### Academic research on climate change
A researcher needs data for a paper. They use `get_articles_by_language` and `search_articles` to pull only articles written in French or Spanish that mention 'sea level' over the last decade, ignoring general news.

### Daily market sentiment check
A financial analyst needs a quick overview of global risk. The agent calls `get_headlines_by_country` for Japan and Germany, then uses `get_popular_articles` to see what the general public is focusing on right now.

### Content gap analysis
A content strategist wants to know which news sources are missing coverage in a specific area. The agent first runs `list_sources`, then checks if major regional publications are indexed, identifying potential partnerships.

## Benefits

- Deep Historical Search: Instead of reading today's front page, you can search articles from the last five years using `search_articles`, making trend analysis precise.
- Hyper-Specific Monitoring: Need to watch one sector across multiple sources? You can combine tools like `get_headlines_by_category` and `get_articles_from_domains` for surgical precision.
- Global Coverage, Local Focus: Quickly narrow down results using `get_headlines_by_country`, letting your agent filter out noise and focus only on the target market's top stories.
- Source Verification: Use `list_sources` to see exactly which publishers are indexed. This helps you vet data quality before relying on a specific source for your research.
- Efficiency in Copy-Pasting: Don't copy headlines from ten tabs. Use this MCP to feed all the required metadata directly into your agent's context window.

## How It Works

The bottom line is, you get a single, reliable method to pull complex news data without writing any code or navigating dozens of separate websites.

1. Subscribe to this MCP on Vinkius, then input your personal NewsAPI key into your AI client.
2. Tell your agent the specific news data you need—for example, 'Show me tech headlines in Germany from last week.'
3. The connection sends the request through the API and returns structured article data for immediate analysis by your agent.

## Frequently Asked Questions

**How does NewsAPI MCP handle real-time breaking news?**
It uses tools like `get_headlines_by_category` to pull live updates for specific topics. This means your agent gets the freshest information immediately, allowing you to react fast.

**Can NewsAPI MCP search articles older than a year?**
Yes. The API supports deep historical research, enabling searches across five years of archived content using tools like `search_articles`.

**Is NewsAPI MCP only for English news?**
No. It handles multiple languages. You can restrict your search results to specific language codes, such as Portuguese or Spanish, with the `get_articles_by_language` tool.

**How do I find out which news organizations are available?**
You use the dedicated `list_sources` tool. This immediately gives you a comprehensive list of every indexable publisher, saving you from guessing what sources exist.

**What if I want to monitor only tech news from California websites?**
You would combine tools like `get_articles_from_domains` with category filters. This allows your agent to narrow the scope down to a specific industry and geographic area.