# New York Times MCP for AI Agents AI Agent Connect > New York Times MCP connects your AI agent to the New York Times archives. It lets you pull breaking news, search a massive archive of journalism going back to 1851, and grab cultural data like book best-seller lists and movie reviews. Use it to ground your research in high-quality reporting or to find historical context for modern events. ## Overview - **Category:** knowledge-management - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Lex2ofQWlAyV3K3Um6YkaPdR2TvAj0YyZULynJbO/ai-agent-connect - **Tags:** journalism, news-archive, content-search, data-retrieval, historical-data, media-api ## Description This Connector connects your AI agent to the New York Times archives, giving you a direct line to over 170 years of journalism. It's built for people who need more than just a summary; it's for those who need the actual reporting. You can ask your agent to pull breaking news from specific sections like sports or technology, or you can dive deep into the past. Because the archive goes back to 1851, you can find out how historical events were first reported, which is a game changer for researchers and historians. It also handles cultural data, letting you pull current book best-seller lists or find critic summaries for classic and modern movies. Instead of spending hours clicking through different tabs and trying to find a specific date, you just ask your agent to do the heavy lifting. It pulls the data, summarizes the highlights, and puts it right in front of you. It's a huge leap for anyone who needs to move past surface-level summaries and get to the actual reporting. It's about moving from searching to knowing by having the best journalism in the world available at your fingertips. By using this Connector through the Vinkius catalog, you get a reliable way to turn the Paper of Record into a functional knowledge base for your daily work. ## Tools ### get_book_lists This tool retrieves current or historical best-seller lists. You can use it to see what's trending in different book categories. ### get_most_shared This tool identifies the most shared articles on social media. It's great for gauging public engagement and viral trends. ### get_most_viewed This tool gets the most viewed articles from the paper. It shows you what's capturing the most attention. ### get_movie_reviews This tool searches for movie reviews in the NYTimes archive. It lets you find critic summaries for thousands of films. ### search_articles This tool searches for articles using keywords, date ranges, and sorting. It's the primary way to find specific historical reports. ### get_sections This tool lists all available news sections. Use it to see every topic the paper covers. ### get_top_stories This tool gets top stories for a specific section. It's the fastest way to see the latest headlines in a category. ### get_most_emailed This tool finds the most emailed articles for a specific period. It helps you see what readers are sharing privately. ### get_archive This tool gets all articles for a specific month. It's useful for seeing a snapshot of news from a particular time. ## Prompt Examples **Prompt:** ``` What are the top stories in the tech section today? ``` **Response:** ``` ### Today's Top Tech Stories | Headline | Summary | | :--- | :--- | | **Global Chip Shortage** | New reports on manufacturing delays in East Asia. | | **AI Regulation Update** | Governments move to establish new safety standards. | | **Startup Funding Drop** | Venture capital trends show a shift toward profitability. | *These stories are pulled directly from the latest tech news.* ``` **Prompt:** ``` What was the #1 hardcover fiction book in 2010? ``` **Response:** ``` The #1 Hardcover Fiction book for that period was **"The Road" by Cormac McCarthy**. It held a significant position on the best-seller lists during that timeframe. ``` **Prompt:** ``` Find some reviews for 'Pulp Fiction'. ``` **Response:** ``` ### Archive Movie Reviews: Pulp Fiction * **Original Review (1994):** "A magnificent, stylized masterpiece of independent filmmaking." * **Retrospective Review:** "Still stands as a cornerstone of 90s cinema, lauded for its non-linear structure." *Reviews retrieved from the NYTimes archive.* ``` ## Capabilities ### Pull breaking news Get the latest stories from specific categories like sports or tech. ### Search historical archives Find specific articles from any point between 1851 and today. ### Track viral content See what articles are getting the most shares and emails. ### Check book best-sellers Retrieve current and past rankings for various book genres. ### Retrieve movie reviews Search for critic summaries and reviews of thousands of films. ### Discover news categories List all the different sections and topics covered by the paper. ## Use Cases ### Historical research A historian wants to see how a 19th-century strike was reported. They ask for news from a specific month in 1880. ### Content strategy A social media manager wants to know what's trending. They ask for the most shared articles from the last 7 days. ### Book discovery A librarian wants to see what's popular. They ask for the current hardcover fiction best-seller list. ### Fact-checking A writer needs to verify a quote. They ask the agent to find the original review of a classic movie from the archive. ## Benefits - Use get_most_shared to see what's actually going viral. This lets you skip the noise and see what people are talking about on social media. - Access the full archive using search_articles. You can find specific reports from the 1800s to see how history was written in real-time. - Get accurate book trends with get_book_lists. It helps you identify which authors are moving the needle in different genres. - Pull high-quality movie reviews with get_movie_reviews. You can quickly find critic summaries for classic films or new releases. - Stay updated on specific categories with get_top_stories. It lets your agent pull the latest news in tech or sports without extra searching. ## How It Works The bottom line is you get a direct pipeline to high-quality journalism without the manual searching. 1. Subscribe to this Connector on Vinkius and grab your NYTimes Developer API Key. 2. Plug your key into your AI client's configuration. 3. Ask your agent to find news, search the archives, or check book lists. ## Frequently Asked Questions **Can the New York Times MCP find articles from the 1800s?** Yes, it can search the entire archive dating back to 1851. This makes it a powerful tool for historical research. **How do I see what's trending on social media with the New York Times MCP?** You can use the most shared tool to see which articles are getting the most traction on social platforms. **Can I use the New York Times MCP for book research?** Yes, it includes best-seller lists for various categories, making it easy to track book trends over time. **Does the New York Times MCP cover movie reviews?** Yes, it pulls critic summaries and reviews for thousands of films from the archive. **Can I search for news by date with the New York Times MCP?** Yes, you can set specific date ranges to find news from any point in history. **How far back does the NYTimes archive go?** The article search API provides access to articles dating back to 1851. It is one of the most comprehensive historical newspaper archives available. **Can I get the actual text of the articles?** The API provides the headline, abstract (summary), snippet, and URL to the full article on NYTimes.com. Full text is not included in the API response but can be accessed via the provided link. **What sections are available for Top Stories?** You can access almost any section of the NYTimes, including home, world, politics, business, technology, sports, arts, health, and science. Use the get_sections tool to see the full list.