# New York Times MCP > New York Times MCP connects your AI agent directly to over 170 years of global journalism. Search archives from 1851 forward, track historical trends, pull today's top stories by section (Politics, World, Tech), and access best-seller lists and film reviews—all in one place. ## Overview - **Category:** knowledge-management - **Price:** Free - **Tags:** journalism, news-archive, content-search, data-retrieval, historical-data, media-api ## Description Think about the sheer volume of information sitting across decades: breaking news reports, cultural critiques, market shifts. This MCP gives your AI agent direct access to that archive. Instead of relying on summaries or limited databases, you can query the full scope of modern journalism, cross-referencing topics and dates from 1851 right up to today. It’s more than just reading headlines; it’s historical context in real time. You can pull top stories for a specific section, narrow your search by keywords and date ranges, or see what was most shared across social media on any given day. The Vinkius catalog makes this massive dataset available to every MCP-compatible client you use. Whether you're writing an academic paper that needs background coverage from 1920, researching the cultural impact of a modern tech policy, or just checking out what books were trending last month, this connector handles it. It brings world-class journalism into your agent's hands. ## Tools ### get_archive Retrieves every article published during a specified calendar month. ### get_book_lists Gets current or historical best-seller lists for different book categories. ### get_most_emailed Finds the articles that were most shared via email over a 1, 7, or 30 day period. ### get_most_shared Retrieves articles that saw the highest social media sharing counts in the last 1, 7, or 30 days. ### get_most_viewed Identifies the most read and viewed articles across all sections. ### get_movie_reviews Searches the archive specifically for film critiques, allowing filtering by movie title. ### search_articles Performs keyword searches across the entire database, letting you filter by date range and sort order. ### get_sections Lists every available topic or news section covered by the New York Times. ### get_top_stories Gets today's top headline stories for a specific defined section, like World or Sports. ## Prompt Examples **Prompt:** ``` Show me today's top world news. ``` **Response:** ``` Top World Headlines: 1. Global Summit Reaches Climate Deal. 2. Elections in Europe Shift Political Landscape. 3. Tech Giants Face New Regulations in Asia. ``` **Prompt:** ``` What is the #1 Hardcover Fiction book this week? ``` **Response:** ``` This Week's #1 Hardcover Fiction: 'The Midnight Library' by Matt Haig. It has been on the list for 12 weeks. ``` **Prompt:** ``` Find movie reviews for 'The Godfather'. ``` **Response:** ``` Found classic NYTimes reviews: 1. Original 1972 Review by Vincent Canby — 'A magnificent film'. 2. Retrospective reviews from later decades. ``` ## Capabilities ### Tracking Historical Shifts Pull articles and reports from specific years to track how a topic or event was covered over decades. ### Analyzing Trending Content Determine which stories were the most viewed, shared on social media, or emailed during any 1-, 7-, or 30-day period. ### Searching Deep Archives Use keywords and precise date ranges (YYYYMMDD) to find specific articles across the entire publication history. ### Gathering Current Headlines Get the day's top stories instantly, filtered by major sections like World, Politics, or Technology. ### Accessing Cultural Data Retrieve current and historical book best-seller lists or search for movie reviews using specific titles. ## Use Cases ### Tracking Policy Shifts Over Time A historian needs to understand how the coverage of climate change shifted between 1980 and 2000. They use `search_articles` with a date range, finding direct comparison pieces that show the evolution of public discourse. ### Writing an Industry Deep Dive A journalist needs to write about a tech company's rise. Instead of guessing, they use `get_top_stories` for 'Technology' and then follow up with `search_articles` to pull specific early coverage dates, building a fully sourced narrative. ### Monitoring Viral Topics A marketing team wants to know what topics generate buzz. They run `get_most_shared` for the last 7 days, immediately identifying which cultural or political subjects are currently dominating social conversation. ## Benefits - Contextual depth: Use the `search_articles` tool to find articles from specific date ranges, allowing you to compare how a single event was reported decades apart. - Trend Spotting: Check what's popular right now. The `get_most_emailed`, `get_most_shared`, and `get_most_viewed` tools tell you exactly where the public attention is focused in any given period. - Broad Coverage: Need to know about books or films? You can check out best-seller lists using `get_book_lists` or find movie critiques with `get_movie_reviews`, all from one source. - Targeted News Retrieval: Don't waste time sifting through everything. Use `get_top_stories` to get the absolute latest headlines for a specific topic, like Politics or Tech. - Structural Research: Start by running `get_sections` to map out every possible content area before you even start searching for keywords. ## How It Works The bottom line is that your agent stops needing general internet searches and starts asking targeted questions against a verified, deep repository of journalism. 1. Subscribe to this MCP on Vinkius and enter your New York Times Developer API Key. 2. Your AI agent uses the connection credentials to initiate a query, specifying criteria like keywords, date ranges, or sections (e.g., 'World Politics'). 3. The system returns structured data containing article summaries, full text snippets, and related contextual information from the archive. ## Frequently Asked Questions **Can I use New York Times MCP to find articles about a specific month?** Yes, you can use the `get_archive` tool. This function retrieves all published articles within an entire calendar month for comprehensive coverage. **Does New York Times MCP cover more than just news stories?** Absolutely. Beyond top stories and archives, this MCP also includes tools for best-seller lists using `get_book_lists` and movie reviews via `get_movie_reviews`. **How do I find out what was popular last year?** You can use the trending tools. Run `get_most_shared` or `get_most_emailed`, specifying a 30-day period within the past year to pinpoint peak interest. **Can I search for articles using keywords and dates in New York Times MCP?** Yes, that's exactly what `search_articles` is for. You provide your keywords and define a precise date range (YYYYMMDD) to focus your search. **What kind of sections are available in the New York Times MCP?** You use the `get_sections` tool first. This lists all currently active topics, ensuring you know exactly which categories (like World or Sports) you can pull top stories from.