MonteWalk

Instructions

Retrieves recent news headlines for a given symbol.

Args:
    symbol: Ticker symbol.
    max_items: Maximum number of news items to return.

Returns:
    JSON string of news articles with titles and publishers.

Implementation Reference

• tools/news_intelligence.py:20-84 (handler)

  The core handler function for the 'get_news' tool. Fetches recent news headlines for a given stock symbol using yfinance, with fallbacks to NewsAPI and Google News if no results. Returns formatted JSON with title, publisher, and link.

  def get_news(symbol: str, max_items: int = 10) -> str:
      """
      Retrieves recent news headlines for a given symbol.
      
      Args:
          symbol: Ticker symbol.
          max_items: Maximum number of news items to return.
      
      Returns:
          JSON string of news articles with titles and publishers.
      """
      try:
          ticker = yf.Ticker(symbol)
          news = ticker.news
          
          if not news:
              # Try NewsAPI first if available
              if NEWSAPI_KEY:
                  logger.info(f"yfinance news empty for {symbol}, trying NewsAPI")
                  newsapi_results = get_newsapi_articles(symbol, max_items)
                  if newsapi_results:
                      import json
                      return json.dumps(newsapi_results, indent=2)
              
              # Fallback to Google News
              logger.info(f"Trying GNews fallback for {symbol}")
              gnews_results = get_google_news(symbol, max_items)
              if gnews_results:
                  import json
                  return json.dumps(gnews_results, indent=2)
              
              logger.warning(f"No news found for {symbol} from any source")
              return f"No news found for {symbol}"
          
          # Limit results
          news = news[:max_items]
          
          # Extract relevant fields (handle nested yfinance structure)
          results = []
          for item in news:
              # yfinance returns nested structure with 'content' key
              content = item.get("content", item)  # fallback to item if no content key
              title = content.get("title", "")
              
              # Publisher info is in 'provider' dict
              provider = content.get("provider", {})
              publisher = provider.get("displayName", "") if isinstance(provider, dict) else item.get("publisher", "")
              
              link = content.get("canonicalUrl", {}).get("url", "")
              if not link:
                  link = item.get("link", "")
              
              results.append({
                  "title": title,
                  "publisher": publisher,
                  "link": link,
              })
          
          logger.info(f"Fetched {len(results)} news items for {symbol} from yfinance")
          import json
          return json.dumps(results, indent=2)
          
      except Exception as e:
          logger.error(f"Error fetching news for {symbol}: {e}", exc_info=True)
          return f"Error fetching news for {symbol}: {str(e)}"

• server.py:405-408 (registration)

  Registers the get_news function as an MCP tool in the FastMCP server, along with related sentiment analysis tools.

  register_tools(
      [get_news, analyze_sentiment, get_symbol_sentiment],
      "News & Sentiment"
  )

• tools/news_intelligence.py:110-144 (helper)

  Helper function called by get_news as fallback when yfinance returns no news. Fetches articles from NewsAPI.org.

  def get_newsapi_articles(symbol: str, max_items: int = 5) -> List[Dict]:
      """
      Fetches news from NewsAPI.org using the company name or symbol.
      """
      if not NEWSAPI_KEY:
          logger.warning("NewsAPI key not configured")
          return []
          
      try:
          newsapi = NewsApiClient(api_key=NEWSAPI_KEY)
          
          # Search for the symbol (NewsAPI works better with company names, but symbols can work)
          # We'll search in business category for relevance
          response = newsapi.get_everything(
              q=symbol,
              language='en',
              sort_by='publishedAt',
              page_size=max_items
          )
          
          articles = response.get('articles', [])
          cleaned = []
          for article in articles:
              cleaned.append({
                  "title": article.get("title", ""),
                  "publisher": article.get("source", {}).get("name", "Unknown"),
                  "link": article.get("url", ""),
                  "published": article.get("publishedAt", ""),
                  "description": article.get("description", "")
              })
          return cleaned
      except Exception as e:
          logger.error(f"NewsAPI error for {symbol}: {e}")
          return []

• tools/news_intelligence.py:87-108 (helper)

  Secondary fallback helper for fetching news from Google News using GNews library.

  def get_google_news(symbol: str, max_items: int = 5) -> List[Dict]:
      """
      Fetches news from Google News via GNews library.
      """
      try:
          google_news = GNews(max_results=max_items)
          # Search for the symbol
          results = google_news.get_news(symbol)
          
          cleaned = []
          for item in results:
              cleaned.append({
                  "title": item.get("title", ""),
                  "publisher": item.get("publisher", {}).get("title", "Unknown"),
                  "link": item.get("url", ""),
                  "published": item.get("published date", "")
              })
          return cleaned
      except Exception as e:
          logger.error(f"GNews error for {symbol}: {e}")
          return []

• server.py:19-19 (registration)

  Import statement that brings the get_news handler into the server module for registration.

  from tools.news_intelligence import get_news, analyze_sentiment, get_symbol_sentiment