# WorldNewsAPI MCP

> WorldNewsAPI searches global news sources and audits articles for any AI agent. Need to track geopolitical shifts or monitor market sentiment? This MCP instantly retrieves real-time news, pulls top stories by country, and extracts deep content metadata from specific links without you ever visiting a news website. It's your full media research toolkit built right into your workflow.

## Overview
- **Category:** artificial-intelligence
- **Price:** Free
- **Tags:** news-aggregation, media-monitoring, real-time-data, journalism-api, content-metadata, global-news

## Description

This connection lets your AI agent handle complex global journalism tasks through natural conversation. Instead of spending hours opening dozen different tabs to manually gather data, your agent pulls together verified intelligence from around the world. You can ask it to search for news articles based on a simple keyword or phrase, getting a clear view of how many major outlets are talking about a topic right now. It'll also audit top stories across specific countries and languages, so you know who's leading the information flow in any region. If you get a link to a story, your agent can extract all the high-resolution content and metadata needed for deep classification. When you connect WorldNewsAPI via Vinkius, your AI client acts like a real-time news analyst, making sure your intelligence is always precise and ready for immediate use.

## Tools

### check_api_status
Confirms whether the WorldNews service is currently online and ready for use.

### extract_news_from_url
Pulls all the article text and metadata from a specific news URL you provide.

### get_top_world_news
Fetches the current top headlines for any specified country and language combination.

### search_world_news
Searches across multiple global sources to find articles matching a keyword or phrase.

## Prompt Examples

**Prompt:** 
```
Search for news about 'artificial intelligence' using WorldNewsAPI.
```

**Response:** 
```
I've retrieved several articles about artificial intelligence! Notable headlines include updates on new model releases and industry regulations. Would you like the full text or the source metadata for any of these stories?
```

**Prompt:** 
```
Show the top stories in 'United Kingdom' in 'English'.
```

**Response:** 
```
I've identified the top stories for the UK in English! They cover current events from major British publishers. I can provide the summary and direct links for each of these articles if you'd like.
```

**Prompt:** 
```
Extract the news content from 'https://www.bbc.com/news/example-article'.
```

**Response:** 
```
I've retrieved the article content! The text covers [Summary]. I can also assist you with the publication date and author metadata for this specific link.
```

## Capabilities

### Search by keywords
Find thousands of recent articles across global media using specific phrases or topics.

### Audit top headlines
Check the most prominent stories and current leads for any country and language combination.

### Extract content from URLs
Pull all the raw article text and metadata directly from a specific news link.

### Check service status
Verify that the WorldNews API connection is running and operational before starting research.

## Use Cases

### Tracking a sudden market shift
A market researcher needs to know if a new trade tariff is gaining traction in Asia. They ask their agent to run the search_world_news tool for 'trade tariffs' and then use get_top_world_news for Japan/Japanese to see which local outlets are leading the discussion.

### Verifying geopolitical buzz
A policy lead needs confirmation on a regional conflict. They use search_world_news first, followed by extract_news_from_url on three different articles to compare the source metadata and see which narrative is most dominant.

### Preparing for an international pitch
A journalist needs context on current events in Brazil. They use get_top_world_news to grab headlines, then ask their agent to search_world_news using a specific theme to build out background material.

### Automating competitive intelligence
A competitor analyst needs to know what rivals are saying about AI ethics. They use the search_world_news tool with multiple industry keywords and then check_api_status first to ensure reliable data flow for their team.

## Benefits

- Go beyond simple searches. Use the search_world_news tool to find articles by specific keywords, giving you a clear picture of how widely a topic is covered globally.
- Understand regional influence with get_top_world_news. You can audit the top stories for any country and language, letting you pinpoint current information leaders instantly.
- Deep-dive into sources using extract_news_from_url. Instead of copying chunks of text, this tool pulls all content and metadata directly from a single news link.
- Verify your process before you start by running check_api_status. This makes sure your media research workflow is always operational when deadlines loom.
- Keep track of complex stories by grouping tools. For example, search_world_news can pull leads that you then feed into extract_news_from_url for deep context.

## How It Works

The bottom line is you get automated access to global journalism intelligence right inside your chat window.

1. Subscribe to this MCP, then enter your unique WorldNewsAPI key.
2. Connect it in your preferred AI client (like Claude or Cursor).
3. Your agent can then call the tools—for example, asking it to 'search for news about energy regulations'—and receive structured data.

## Frequently Asked Questions

**Can WorldNewsAPI find news from private sources?**
No. WorldNewsAPI is designed to audit public global journalism. It pulls content and metadata only from major, publicly available news websites.

**How do I use search_world_news with multiple keywords?**
You can prompt your agent to run the tool several times or group related phrases into a single request. This lets you compare how different topics are being covered simultaneously.

**Do I need an API key for WorldNewsAPI MCP?**
Yes, you must subscribe and enter your unique WorldNewsAPI Key in the Vinkius marketplace to authorize access to the service's tools.

**What is the difference between search_world_news and get_top_world_news?**
get_top_world_news gives you the most popular, current headlines for a region. search_world_news lets you hunt specifically for articles matching your own defined topic or phrase.

**Is WorldNewsAPI good for technical jargon?**
Yes. By pulling content and metadata from URLs using extract_news_from_url, it captures the full depth of reporting, including specialized industry terminology.