# Marketaux MCP

> Marketaux connects your AI agent directly to global financial data. It lets you search news by symbol, check real-time market status, get sentiment scores for articles, and list indices like S&P 500 or NASDAQ. Stop looking up symbols manually; just ask the agent.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** financial-news, market-sentiment, stock-market-data, investment-research, real-time-finance

## Description

Look, forget those clunky interfaces you're used to. Marketaux connects your agent straight into the global financial data feed. You stop wasting time manually looking up symbols or checking multiple websites; your AI client handles it all in natural conversation.

**Fetching Real-Time Market Status and Indices**
You wanna know if a market's open? Just ask. Your agent uses `get_stock_market_status` to check the current operating status of major global exchanges, so you always know when trading starts or stops. You can also run `get_indices` to pull up key stock market indices, like the S&P 500 or NASDAQ figures.

**Searching and Analyzing Global News**
Want news on a specific company? Use `get_entities` to grab detailed data points for recognized financial entities—it works whether you're querying a whole exchange, a specific industry using `list_industries`, or just a major corporation. If you need to find articles related to something else, your agent can use `search_news`; this tool searches the entire archive of global financial reports based on keywords and filters. You can also narrow your focus by first running `get_symbols` to list every supported financial ticker symbol before searching for news directly against a specific ticker or using `search_exchanges` to pinpoint an exchange by name or region.

When you get the articles, don't just read 'em and move on. Your agent runs `get_sentiment_analysis` on the content, giving you a quantifiable score that tells you if the overall mood is positive, negative, or neutral for whatever topic you asked about. If you want to see what's hot right now, use `get_trending_news` to pull a feed of currently popular financial topics.

**Querying Structured Market Data**
If you need deep context on the market, your agent uses specialized tools to nail down exactly what you’re looking for. You can query specific details about major companies or financial institutions using `get_entities`. If you're building out a whole sector report, you can run `list_industries` first to get a structured list of major economic sectors to guide your analysis.

**Putting It All Together**
You don't gotta switch between tools. You tell your agent what you need—say, the sentiment around tech stocks in Europe—and it handles the whole chain: it uses `search_news` to pull European articles about technology, then feeds those results into `get_sentiment_analysis`, and maybe even checks the market status using `get_stock_market_status` just to make sure everything is operating during your query. This setup lets you run complex analyses—like checking a specific symbol's news, analyzing its mood, and listing what indices are moving—all through simple conversation with your AI client.

## Tools

### get_entities
Retrieves specific data points on recognized financial entities (e.g., a company or exchange).

### get_indices
Lists key stock market indices, such as the S&P 500 or NASDAQ.

### get_latest_news
Fetches a list of the most recently published financial news articles.

### get_sentiment_analysis
Analyzes provided news content and returns a quantifiable score showing its general market mood.

### get_stock_market_status
Checks the current open/closed status of major global stock exchanges.

### get_symbols
Lists all valid and supported financial ticker symbols that can be queried.

### get_trending_news
Pulls a feed of currently popular or high-interest financial news topics.

### list_industries
Provides a structured list of major economic industries used for market grouping.

### search_exchanges
Performs targeted searches to find specific global stock exchanges by name or region.

### search_news
Searches the entire archive of global financial news using keywords and filters.

## Prompt Examples

**Prompt:** 
```
Show latest news for AAPL and MSFT.
```

**Response:** 
```
Fetching latest news... I found articles regarding Apple's latest earnings and Microsoft's new AI features.
```

**Prompt:** 
```
Check if the stock market is open now.
```

**Response:** 
```
Market status query... Global markets like NYSE and NASDAQ are currently open.
```

**Prompt:** 
```
What are the trending financial topics today?
```

**Response:** 
```
Retrieving trending news... Today's focus is on inflation reports and energy sector shifts.
```

## Capabilities

### Fetch real-time market status
Checks the current operating status of major stock exchanges and global indices.

### Search for financial news articles
Retrieves global news reports based on keywords, symbols, or specific timeframes.

### Determine market sentiment
Applies analysis to retrieved news content, returning a quantifiable score of the overall mood (positive, negative, neutral).

### List all supported stock symbols
Provides a full list of every financial ticker symbol recognized by the Marketaux system.

### Query structured market entities
Retrieves detailed data on companies, industries, and financial institutions.

## Use Cases

### Assessing competitive risk in a sector.
A portfolio manager needs to know if their main competitor (XYZ) is facing bad press. They ask the agent: 'What's the sentiment on XYZ?' The agent runs `get_sentiment_analysis` and `search_news`, providing an immediate score and list of articles, saving hours of manual monitoring.

### Comparing indices across different markets.
A quant needs to know if global trading is active. They first call `get_stock_market_status` for a quick check. Then, they use `get_indices` to pull the current status of three major indexes (Dow, FTSE, Nikkei) and compare them side-by-side.

### Deep diving into a niche industry.
A data scientist wants to model energy sector shifts. They use `list_industries` to confirm the 'Energy' group. Then, they run `get_symbols` and filter by that industry list to get all relevant tickers for modeling.

### Tracking a specific company over time.
An analyst needs all news on Microsoft (MSFT) from the last month related to AI. They run `search_news` with 'MSFT' and 'AI', then use `get_entities` to verify all associated corporate details, creating a complete research dossier.

## Benefits

- Get instant sentiment scores. Don't just read a headline; use `get_sentiment_analysis` to know if the article is genuinely positive or negative for a stock.
- Know when to trade. Before building logic, check the market availability using `get_stock_market_status`. It confirms if NYSE or NASDAQ are actually open right now.
- Focus your search instantly. Instead of wading through general web results, use `search_news` and filter by symbols (like AAPL) to find only relevant articles.
- Understand the whole picture. Use `get_entities` alongside `list_industries`. This lets you map a specific company not just to its ticker, but to its entire economic sector.
- Discover what's hot. Don't wait for your internal team to compile reports; let the agent pull data on today's biggest moves using `get_trending_news`.

## How It Works

The bottom line is, you treat financial research like a chat conversation—you ask a question, and it pulls the live data to answer it.

1. Subscribe to the Marketaux server. Then, paste your unique Marketaux API Token into your AI client's settings.
2. Ask your agent a specific question, like 'What is the current sentiment on tech stocks?'
3. The agent calls the necessary tools (`get_sentiment_analysis`, `get_symbols`) and returns a concise answer with supporting data points.

## Frequently Asked Questions

**How do I check if the market is open using get_stock_market_status?**
You simply ask your agent to 'Check global market status.' The tool returns a direct status report on major exchanges like NASDAQ or LSE, confirming if they are currently trading hours.

**What is the difference between get_symbols and search_news?**
`get_symbols` gives you a static list of all valid tickers. `search_news` uses those symbols to find actual, current news articles that reference them.

**Can I use get_sentiment_analysis on old news? **
The tool processes content provided by the API; if you retrieve older news using `search_news`, you can pass those texts to `get_sentiment_analysis` for historical mood tracking.

**How do I find out what industries are covered?**
Run the `list_industries` tool. This provides a structured list of all sectors (e.g., Biotech, Energy, Tech) you can use to filter your symbol queries.

**What API token do I need when calling get_latest_news?**
You must provide a valid Marketaux API Token for access. This key authenticates your connection and grants the agent permission to pull real-time data, like fetching the latest news articles.

**Does running search_news repeatedly count against a rate limit?**
Yes, repeated calls are subject to standard API rate limits. These limits keep the service stable for all users. Check our official documentation for specific quota details and recommended call frequency.

**When using get_entities, what parameters control the returned data structure?**
The function accepts several filtering parameters, typically including sector or region. You pass these arguments to refine the list of entities; this narrows down the scope and ensures relevant results.

**Are the stock indices listed by get_indices limited to major North American markets?**
No, the index listings are comprehensive. The server covers primary global financial centers and includes major regional market indexes that extend far beyond North America.

**How do I find my Marketaux API Token?**
Log in to your Marketaux account and navigate to the Dashboard to see your API Token.

**What stock symbols are supported?**
Marketaux supports most major global stock symbols. You can use the `get_symbols` tool to search for specific ones.

**Is the sentiment analysis accurate?**
Marketaux uses advanced AI to score news sentiment. Your token is encrypted at rest and injected securely at runtime.