NYTimes Article Search MCP Server

NYTimes Article Search MCP Server

Search New York Times articles via a Model Context Protocol server.

15
Stars
9
Forks
15
Watchers
2
Issues
NYTimes Article Search MCP Server is a TypeScript-based implementation of the Model Context Protocol that enables searching for New York Times articles from the past 30 days using keywords. It integrates with the official New York Times API and exposes a tool for streamlined article queries. Designed for use with systems like Claude Desktop, it includes support for installation via Smithery and provides development utilities such as an inspector for debugging MCP communication. The server handles MCP requests over stdio and securely accesses the NYT API via environment variables.

Key Features

Implements Model Context Protocol server in TypeScript
Searches NYTimes articles from the last 30 days by keyword
Integration with the official New York Times Article Search API
Returns structured article data (title, abstract, URL, date, author)
Stdio-based MCP request handling
Smithery one-command installation support
Configuration support for Claude Desktop client
Environment variable-based API key management
Development scripts for building and watching
MCP Inspector integration for debugging and inspection

Use Cases

Retrieving recent New York Times articles programmatically
Enhancing conversational AI tools with up-to-date news search capabilities
Integrating news retrieval into personal productivity applications
Enabling Claude Desktop users to fetch NYT articles using MCP
Automating news research and aggregation workflows
Testing or demonstrating MCP server capabilities
Building information retrieval pipelines involving trending news
Facilitating AI context expansion by providing real-time news data
Developing tools that require structured news article metadata
Debugging and inspecting MCP-based server communication flows

README

NYTimes Article Search MCP Server

smithery badge

This is a TypeScript-based MCP server that allows searching for New York Times articles from the last 30 days based on a keyword. It demonstrates core MCP concepts by providing:

  • Tools for searching articles
  • Integration with the New York Times API

NYTimes Article Search

Features

Tools

  • search_articles - Search NYTimes articles from the last 30 days based on a keyword
    • Takes keyword as a required parameter
    • Returns a list of articles with title, abstract, URL, published date, and author

Development

Install dependencies:

bash
npm install

Build the server:

bash
npm run build

For development with auto-rebuild:

bash
npm run watch

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

bash
npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Installation

Installing via Smithery

To install NYTimes Article Search for Claude Desktop automatically via Smithery:

bash
npx -y @smithery/cli install nyt --client claude

Manual Installation

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

json
{
  "mcpServers": {
    "nyt": {
      "command": "node",
      "args": ["path/to/your/build/index.js"],
      "env": {
        "NYTIMES_API_KEY": "your_api_key_here"
      }
    }
  }
}

Environment Variables

Create a .env file in the root of your project and add your New York Times API key:

NYTIMES_API_KEY=your_api_key_here

Running the Server

After building the project, you can run the server with:

bash
node build/index.js

The server will start and listen for MCP requests over stdio.

License

This project is licensed under the MIT License.

Star History

Star History Chart

Repository Owner

angheljf
angheljf

User

Repository Details

Language JavaScript
Default Branch main
Size 328 KB
Contributors 3
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

JavaScript
64.18%
TypeScript
23.35%
Dockerfile
12.47%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • MCP Claude Hacker News

    MCP Claude Hacker News

    Seamless Hacker News integration for Claude Desktop via Model Context Protocol.

    MCP Claude Hacker News is an MCP server that enables Claude Desktop to access, browse, and interact with Hacker News content. It allows users to view the latest, top, and best-rated stories, retrieve detailed information, and read story comments in a clean, structured format. Designed for easy integration, it supports both manual launch and automated startup with Claude Desktop.

    • 9
    • MCP
    • imprvhub/mcp-claude-hackernews
  • Hacker News MCP Server

    Hacker News MCP Server

    An MCP server for accessing and analyzing Hacker News stories, comments, and users.

    Hacker News MCP Server implements the Model Context Protocol to provide tools for fetching and searching Hacker News stories, retrieving story comments, and accessing user information. It integrates seamlessly with AI assistants like Claude Desktop and supports use via Smithery. The server is designed for structured information retrieval, contextual exploration, and summarization of Hacker News content.

    • 55
    • MCP
    • erithwik/mcp-hn
  • tavily-search MCP server

    tavily-search MCP server

    A search server that integrates Tavily API with Model Context Protocol tools.

    tavily-search MCP server provides an MCP-compliant server to perform search queries using the Tavily API. It returns search results in text format, including AI responses, URLs, and result titles. The server is designed for easy integration with clients like Claude Desktop or Cursor and supports both local and Docker-based deployment. It facilitates AI workflows by offering search functionality as part of a standardized protocol interface.

    • 44
    • MCP
    • Tomatio13/mcp-server-tavily
  • Confluence Communication Server MCP Server

    Confluence Communication Server MCP Server

    Seamlessly interact with Confluence using standardized MCP tools.

    Confluence Communication Server MCP Server is a TypeScript-based implementation that enables seamless interaction with Confluence through the Model Context Protocol. It provides tools for running CQL queries, retrieving, and updating Confluence page content, thus showcasing and adhering to core MCP concepts. The server is compatible with Claude Desktop and supports installation via Smithery, emphasizing ease of integration and automation for Confluence management tasks.

    • 13
    • MCP
    • KS-GEN-AI/confluence-mcp-server
  • Dappier MCP Server

    Dappier MCP Server

    Real-time web search and premium data access for AI agents via Model Context Protocol.

    Dappier MCP Server enables fast, real-time web search and access to premium data sources, including news, financial markets, sports, and weather, for AI agents using the Model Context Protocol (MCP). It integrates seamlessly with tools like Claude Desktop and Cursor, allowing users to enhance their AI workflows with up-to-date, trusted information. Simple installation and configuration are provided for multiple platforms, leveraging API keys for secure access. The solution supports deployment via Smithery and direct installation with 'uv', facilitating rapid setup for developers.

    • 35
    • MCP
    • DappierAI/dappier-mcp
  • Google News MCP Server

    Google News MCP Server

    A Model Context Protocol server providing Google News search with smart categorization and multi-language support.

    Implements a Model Context Protocol (MCP) server that integrates with SerpAPI to deliver advanced Google News search capabilities. Automatically categorizes news results, supports various languages and regions, and provides multiple search options such as query-based and topic search. Features robust error handling and flexible response types to suit diverse application needs.

    • 93
    • MCP
    • ChanMeng666/server-google-news
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results