Pitstop

Instructions

Implementation Reference

• tools/media/news.py:10-219 (handler)

  Core handler function for the get_f1_news tool. Fetches recent F1 news from 25+ RSS sources, applies advanced filtering by keywords, driver, team, circuit, year, and dates, returns structured NewsResponse.
  def get_f1_news( source: str = "all", limit: int = 10, keywords: Optional[str] = None, driver: Optional[str] = None, team: Optional[str] = None, circuit: Optional[str] = None, year: Optional[int] = None, date_from: Optional[str] = None, date_to: Optional[str] = None ) -> NewsResponse: """ **PRIMARY TOOL** for RECENT Formula 1 news from 25+ authoritative F1 sources via RSS feeds. ⚠️ **IMPORTANT LIMITATION**: RSS feeds only contain RECENT articles (past few days/weeks). This tool CANNOT retrieve historical news from months or years ago (e.g., 2013, 2020, etc.). **For historical F1 news (older than ~2 months), use web search instead.** **USE THIS TOOL FOR:** - ✅ Latest breaking F1 news and updates - ✅ Current race weekend coverage - ✅ Recent driver/team announcements (within past few weeks) - ✅ Current season news filtering by driver, team, circuit - ✅ Technical developments and regulations from recent weeks **DO NOT use this tool for:** - ❌ Historical news from past years (e.g., "2013 Indian GP", "2020 season") - ❌ News older than ~2 months - ❌ Historical race coverage or archived articles **Available Sources (25+ RSS Feeds):** Official Sources: - "formula1" - Official Formula 1 website - "fia" - FIA press releases Major Outlets: - "autosport" - Autosport F1 - "motorsport" - Motorsport.com F1 - "the-race" - The Race - "racefans" - RaceFans.net - "planetf1" - PlanetF1 - "crash" - Crash.net F1 - "grandprix" - GrandPrix.com - "espnf1" - ESPN F1 - "skysportsf1" - Sky Sports F1 Specialist & Technical: - "f1technical" - F1Technical.net - "pitpass" - Pitpass - "joe-saward" - Joe Saward's F1 Blog - "racecar-engineering" - Racecar Engineering Regional & International: - "gpblog" - GPBlog (Dutch/English) - "f1i" - F1i.com - "f1-insider-de" - F1 Insider (German) - "formel1-de" - Formel1.de (German) Community & Fan Sources: - "wtf1" - WTF1 - "racingnews365" - RacingNews365 - "formulanerds" - Formula Nerds - "f1destinations" - F1 Destinations - "gpfans" - GPFans - "motorsportweek" - Motorsport Week - "racedepartment" - Race Department Args: source: Specific source or "all" (default) - see full list above limit: Maximum articles to return, 1-100 (default: 10) keywords: General search keywords (searches in title and summary) driver: Filter by driver name (e.g., "Verstappen", "Hamilton", "Leclerc") team: Filter by team/constructor name (e.g., "Red Bull", "Ferrari", "Mercedes") circuit: Filter by circuit/track name (e.g., "Monaco", "Silverstone", "Spa") year: Filter by year (e.g., 2024) - NOTE: Only works for current/recent articles in feed date_from: Start date "YYYY-MM-DD" or "YYYY-MM" (optional) date_to: End date "YYYY-MM-DD" or "YYYY-MM" (optional) Returns: NewsResponse with articles including titles, links, publication dates, summaries, and source names. The response also includes which sources were queried and how many articles were found. Examples: get_f1_news() → Latest F1 news from all 25+ sources get_f1_news(driver="Verstappen", limit=5) → Recent news about Verstappen get_f1_news(team="Ferrari") → Recent Ferrari news get_f1_news(circuit="Monaco") → Recent Monaco-related news get_f1_news(keywords="crash OR incident") → Recent crash/incident news get_f1_news(source="autosport", keywords="technical") → Technical news from Autosport get_f1_news(driver="Hamilton", team="Ferrari") → News about Hamilton and Ferrari """ # Validate limit if not 1 <= limit <= 100: raise ValueError("Limit must be between 1 and 100") # Determine fetch limit: fetch more if filtering is applied has_filters = any([keywords, driver, team, circuit, year, date_from, date_to]) fetch_limit = min(limit * 3, 100) if has_filters else limit # Fetch news from source(s) news_response = rss_client.get_news(source=source, limit=fetch_limit) filtered_articles = news_response.articles # Apply driver filtering if driver: driver_lower = driver.lower() filtered_articles = [ article for article in filtered_articles if driver_lower in article.title.lower() or driver_lower in article.summary.lower() ] # Apply team filtering if team: team_lower = team.lower() filtered_articles = [ article for article in filtered_articles if team_lower in article.title.lower() or team_lower in article.summary.lower() ] # Apply circuit filtering if circuit: circuit_lower = circuit.lower() # Also check for common variations (e.g., "Monaco" matches "Monaco GP", "Circuit de Monaco") filtered_articles = [ article for article in filtered_articles if circuit_lower in article.title.lower() or circuit_lower in article.summary.lower() ] # Apply keyword filtering if keywords: keywords_lower = keywords.lower() # Support OR operator for multiple keywords if " or " in keywords_lower: keyword_list = [kw.strip() for kw in keywords_lower.split(" or ")] filtered_articles = [ article for article in filtered_articles if any(kw in article.title.lower() or kw in article.summary.lower() for kw in keyword_list) ] else: # Single keyword or phrase filtered_articles = [ article for article in filtered_articles if keywords_lower in article.title.lower() or keywords_lower in article.summary.lower() ] # Apply date filtering # Convert year to date_from/date_to if specified if year: if not date_from: date_from = f"{year}-01-01" if not date_to: date_to = f"{year}-12-31" if date_from or date_to: date_filtered = [] for article in filtered_articles: try: # Parse article date (handling various formats) article_date = datetime.fromisoformat(article.published.replace('Z', '+00:00')) article_date_str = article_date.strftime("%Y-%m-%d") # Support month-only filtering (YYYY-MM format) if date_from: compare_from = date_from if len(date_from) > 7 else f"{date_from}-01" if article_date_str < compare_from: continue if date_to: # If month format, get last day of month if len(date_to) == 7: # YYYY-MM format year_val = int(date_to.split('-')[0]) month_val = int(date_to.split('-')[1]) # Get last day of month if month_val == 12: compare_to = f"{year_val}-12-31" else: next_month = datetime(year_val, month_val + 1, 1) last_day = (next_month - timedelta(days=1)).day compare_to = f"{year_val}-{month_val:02d}-{last_day}" else: compare_to = date_to if article_date_str > compare_to: continue date_filtered.append(article) except Exception: # If date parsing fails, include the article date_filtered.append(article) filtered_articles = date_filtered # Limit results filtered_articles = filtered_articles[:limit] # Return response return NewsResponse( source=source, fetched_at=datetime.now().isoformat(), article_count=len(filtered_articles), articles=filtered_articles )
• server.py:180-180 (registration)

  MCP tool registration for get_f1_news function.
  mcp.tool()(get_f1_news)
• tools/__init__.py:64-64 (registration)

  Lists get_f1_news in tools __all__ for easy import.
  "get_f1_news",
• tools/__init__.py:28-28 (registration)

  Imports get_f1_news from media module into tools package.
  from .media import get_f1_news
• tools/media/news.py:2-20 (schema)

  Input parameters and output type (NewsResponse) define the tool schema.
  from models import NewsResponse from datetime import datetime, timedelta from typing import Optional # Initialize RSS client rss_client = RSSClient() def get_f1_news( source: str = "all", limit: int = 10, keywords: Optional[str] = None, driver: Optional[str] = None, team: Optional[str] = None, circuit: Optional[str] = None, year: Optional[int] = None, date_from: Optional[str] = None, date_to: Optional[str] = None ) -> NewsResponse: