# Currents MCP

> Currents MCP lets your AI agent read global news in real-time. It searches a database of tens of millions of articles, letting you track specific topics or industry trends across multiple countries and languages directly from your client.

## Overview
- **Category:** knowledge-management
- **Price:** Free
- **Tags:** news-api, real-time-news, article-search, media-monitoring, global-news

## Description

Need to know what's happening right now? This connector gives your AI agent direct access to current global media feeds. Instead of running complicated web queries, your agent streams the latest international news as it breaks—no manual filtering needed.

It lets you go deep into archives that hold millions of historical articles. You can narrow down results by country, language, or specific source domain like reuters.com. Want to search for 'AI regulations' AND 'semiconductors'? Your agent handles the complex boolean logic. This capability connects directly to the Vinkius Marketplace, meaning you connect once from any compatible client and get access to this massive data stream.

It’s built for people who need facts fast: market analysts tracking competitor mentions, or researchers needing verifiable data points across different time zones. You just talk to your agent about what you want to know, and it handles the rest.

## Tools

### check_auth
Verifies if the connection key is valid and active for current use.

### list_categories
Pulls a list detailing all available types of news content (e.g., business, sports).

### list_languages
Lists every language supported by the API for filtering results.

### get_latest_news
Retrieves a stream of the most recent international news articles without needing specific search terms.

### list_regions
Provides a list of all countries or regions you can use to narrow down news coverage.

### search_news
Searches the entire archive using advanced keywords or complex boolean logic (AND, OR, NOT).

## Prompt Examples

**Prompt:** 
```
Show me the latest news in technology from the US.
```

**Response:** 
```
I've fetched the latest technology news from the United States. Key headlines include updates on new AI regulations and recent semiconductor breakthroughs. Would you like me to summarize any specific article?
```

**Prompt:** 
```
Search for articles about 'SpaceX' AND 'Mars' from the last 30 days.
```

**Response:** 
```
Searching the archives... I found several articles regarding SpaceX's Mars mission plans and recent Starship tests. I can provide the links and descriptions for the top 5 results.
```

**Prompt:** 
```
What are the available news categories I can filter by?
```

**Response:** 
```
I've retrieved the list of supported categories. You can filter news by: business, entertainment, general, health, science, sports, and technology. Which one interests you?
```

## Capabilities

### Monitoring real-time breaking news
Your AI client streams the absolute latest international articles as they are published.

### Searching complex data sets
You can search millions of archived articles using advanced keywords, including AND or OR logic.

### Refining searches by geography and language
The agent filters results based on specific countries, languages, or media categories.

### Discovering available data points
You list all supported regions, languages, and news categories to scope your search precisely.

## Use Cases

### Tracking a competitor's product launch
A market analyst needs to know if Competitor X is mentioning their new phone model anywhere outside of the US. They ask their agent to `search_news` for 'Competitor X AND Phone Model Z' across multiple regions, instantly compiling a global view.

### Fact-checking historical claims
A researcher needs data on climate policy from the last decade. They use the agent to `search_news` with specific dates and keywords, going far beyond what standard Google searches can retrieve.

### Creating a daily news brief
A content creator wants the top five stories in global technology for a newsletter. They ask their agent to `get_latest_news` filtered by 'Technology' and then summarize the results, saving hours of manual reading.

## Benefits

- Real-time updates eliminate guesswork. Use `get_latest_news` to stream breaking international stories as they happen, giving you immediate awareness of market shifts.
- Advanced searching lets you write complex queries like 'AI AND China NOT regulation'. The `search_news` tool handles the logic so you don't have to build complicated filters.
- Metadata discovery saves time. Before building a query, use `list_languages`, `list_regions`, and `list_categories` to know exactly what data is available in the system.
- Comprehensive coverage means you never miss context. You can filter results by specific domains or sources, giving your research an authoritative edge.
- The entire process is abstracted. Instead of dealing with API calls for every country or language, your agent handles the complexity across all global inputs.

## How It Works

The bottom line is you tell your AI what data you want; it pulls it from global feeds automatically.

1. Subscribe to the Currents MCP and enter your API key.
2. Direct your AI client to run a query using natural language instructions (e.g., 'Show me tech news from Japan').
3. Your agent processes the request, filters the massive dataset, and returns the relevant headlines and article summaries.

## Frequently Asked Questions

**How does the Currents MCP handle advanced searching?**
It uses boolean logic via the `search_news` tool. You can ask for articles that mention 'AI' AND ('regulation' OR 'ethics') to get a highly specific, filtered result set.

**Can I see what languages are supported by Currents MCP?**
Yes. Use the `list_languages` tool first. This gives you a definitive list of available language codes so your agent can accurately filter international news feeds for you.

**Is getting the latest news reliable with Currents MCP?**
The `get_latest_news` tool provides real-time streaming capabilities. This means you get articles as they break, not hours later when a feed updates overnight.

**What is the difference between listing categories and searching news with Currents MCP?**
Listing categories (`list_categories`) just shows you what types of news exist (like 'Sports' or 'Tech'). Searching actually uses those categories to pull articles from the archive.

**How do I verify my connection using the `check_auth` tool?**
The `check_auth` tool immediately verifies your API key status. A successful return confirms that your agent can access global data; if it fails, you know you need to re-enter or update your credentials.

**Does the `list_regions` tool help me filter news by country?**
Yes, it provides a comprehensive list of all supported countries and regions. You can use this list directly within subsequent searches to narrow down results geographically for pinpoint accuracy.

**If I need multiple criteria, how do I structure my query using the `search_news` tool?**
You build complex queries by embedding keywords and standard boolean operators like AND, OR, or NOT. This lets you combine specific concepts, for instance finding articles about 'space' AND 'policy'.

**How do I get older or more results using the `search_news` tool?**
You must handle deep pagination by passing page numbers or cursor-based parameters. This mechanism allows your agent to reliably retrieve large sets of historical articles without hitting data limits.

**How do I find the latest news without specific keywords?**
Use the `get_latest_news` tool. It provides a real-time stream of international news. You can optionally filter by `language`, `country`, or `category` to narrow down the stream.

**Can I search for articles using complex logic like AND/OR?**
Yes! Use the `search_news` tool and provide your logic in the `query` parameter. This allows you to use boolean syntax to find exactly what you need across millions of articles.

**How do I know which country codes or categories are supported?**
You can use the `list_regions` tool to see all supported 2-letter country codes and the `list_categories` tool to see the canonical list of news categories available for filtering.