get_latest_news
Retrieve current New York Times news items from the real-time wire feed, with options to filter by section, source, and pagination.
Instructions
Get the latest news items from the NYT news wire (real-time news feed).
Args: limit: Number of items to return (default: 20) offset: Pagination offset (default: 0) source: News source - "nyt" or "inyt" (default: "nyt") section: News section (default: "all"). e.g. "u.s." or "technology". Use the 'nyt://reference/sections' resource for available section names.
Returns: Formatted response with news_items array containing title, abstract, url, section, subsection, published_date, and byline
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| offset | No | ||
| source | No | nyt | |
| section | No | all |
Implementation Reference
- src/nytimes_mcp/server.py:36-58 (handler)The FastMCP-registered handler for the get_latest_news tool, defining input parameters with type hints and delegating to the get_news_wire helper function.@mcp.tool() async def get_latest_news( limit: int = 20, offset: int = 0, source: tools.NewsSource = "nyt", section: str = "all", ) -> dict: """ Get the latest news items from the NYT news wire (real-time news feed). Args: limit: Number of items to return (default: 20) offset: Pagination offset (default: 0) source: News source - "nyt" or "inyt" (default: "nyt") section: News section (default: "all"). e.g. "u.s." or "technology". Use the 'nyt://reference/sections' resource for available section names. Returns: Formatted response with news_items array containing title, abstract, url, section, subsection, published_date, and byline """ return await tools.get_news_wire(limit, offset, source, section)
- src/nytimes_mcp/tools.py:92-124 (helper)The primary helper function implementing the NYT news wire API call, parameter construction, client usage, and response formatting.async def get_news_wire( limit: int = 20, offset: int = 0, source: NewsSource = "nyt", section: str = "all", ) -> dict: """ Get the latest news items from the NYT news wire (real-time news feed). Args: limit: Number of items to return (default: 20) offset: Pagination offset (default: 0) source: News source - "nyt", "inyt", or "all" (default: "nyt") section: News section (e.g., "all", "world", "business") (default: "all"). To see the latest list of sections available, refer to the get_news_sections tool. Returns: Formatted response with news_items array containing title, abstract, url, section, subsection, published_date, and byline """ params = { "limit": limit, "offset": offset, } client = get_client() response = await client.make_nyt_request( f"news/v3/content/{source}/{section}.json", params ) return format_news_items_response(response)
- src/nytimes_mcp/tools.py:25-25 (schema)Type alias defining valid values for the 'source' parameter, used for input validation via type hints.type NewsSource = Literal["nyt", "inyt", "all"]
- src/nytimes_mcp/utils.py:32-59 (helper)Utility function that transforms the raw NYT news wire API response into a clean, structured format with a news_items array containing key fields.def format_news_items_response(response: dict[str, Any]) -> dict[str, Any]: """ Format times wire (news feed) response to extract essential fields. Args: response: Raw NYT times wire API response Returns: Formatted response with news_items array and num_results """ if "results" in response: return { "news_items": [ { "title": item.get("title", ""), "abstract": item.get("abstract", ""), "url": item.get("url", ""), "section": item.get("section", ""), "subsection": item.get("subsection", ""), "published_date": item.get("published_date", ""), "byline": item.get("byline", ""), } for item in response["results"] ], "num_results": len(response["results"]), } return response