Skip to main content
FinMCP provides two tools for retrieving news articles related to ticker symbols: yf_ticker_news for a single ticker and yf_tickers_news for multiple tickers simultaneously.

Single Ticker News

The yf_ticker_news tool retrieves news articles for a specific ticker symbol.

Parameters

ticker
string
required
Ticker symbol (e.g., “AAPL”, “MSFT”, “TSLA”)
response_format
string
default:"json"
Output format for the response
  • json - Returns structured JSON data
  • markdown - Returns formatted markdown tables
preview_limit
number
default:"25"
Maximum number of rows to display in markdown preview (min: 1, max: 200)
save
object
Save the result to a file

Example Usage

{
  "ticker": "AAPL"
}

Multiple Tickers News

The yf_tickers_news tool retrieves news articles for multiple ticker symbols in a single request.

Parameters

tickers
string
required
Space-separated list of ticker symbols (e.g., “AAPL MSFT GOOGL”)
response_format
string
default:"json"
Output format for the response
  • json - Returns structured JSON data
  • markdown - Returns formatted markdown tables
preview_limit
number
default:"25"
Maximum number of rows to display in markdown preview (min: 1, max: 200)
save
object
Save the result to a file

Example Usage

{
  "tickers": "AAPL TSLA NVDA"
}

News Data Structure

Both tools return an array of news article objects with the following fields:
  • uuid: Unique identifier for the article
  • title: Article headline
  • publisher: News source/publisher name
  • link: Full URL to the article
  • providerPublishTime: Unix timestamp of publication time
  • type: Article type (typically “STORY”)
  • thumbnail: Image thumbnails with resolutions (when available)
  • relatedTickers: Array of ticker symbols mentioned in the article
News articles may reference multiple tickers in the relatedTickers field. When using yf_tickers_news, you’ll receive all articles related to any of the requested tickers, which may include cross-references to tickers not in your original request.

Comparison: Single vs Multiple Tickers

Featureyf_ticker_newsyf_tickers_news
InputSingle ticker stringSpace-separated tickers
Use CaseFocused news for one companyNews monitoring across portfolio
Related NewsOnly articles mentioning the tickerArticles mentioning any requested ticker
PerformanceFaster for single tickerEfficient for multiple tickers

When to Use Each Tool

Use yf_ticker_news when:
  • You need news for a specific company
  • You’re doing deep research on a single stock
  • You want to minimize response size
Use yf_tickers_news when:
  • You’re monitoring a portfolio of stocks
  • You want to see cross-ticker news coverage
  • You need to compare news sentiment across multiple companies
  • You’re tracking sector or industry news

Build docs developers (and LLMs) love