NYT MCP Server
@aovabo
A Message Concentrator Protocol (MCP) server that provides a unified, simple interface to the New York Times APIs. This server simplifies interaction with multiple NYT APIs through a single endpoint.
Overview
What is NYT MCP Server?
NYT MCP Server is a Message Concentrator Protocol (MCP) server that provides a unified, simple interface to multiple New York Times APIs, including Article Search, Top Stories, Times Wire, Most Popular, Archive, and Books API, through a single endpoint. It simplifies interaction with these NYT APIs for developers building news-related applications.
How to use NYT MCP Server?
Clone the repository, create and activate a Python virtual environment, install dependencies from requirements.txt, create an .env file with your NYT API key and server configuration, then run python src/server.py. The server exposes a POST endpoint at /mcp/message for all NYT API interactions and a GET /health endpoint for monitoring.
Key features of NYT MCP Server
- Single endpoint for all NYT API interactions
- Clean, formatted API responses
- Real-time news feed via Times Wire
- Flexible article search capabilities
- Built-in health check endpoint
- Robust error handling
Use cases of NYT MCP Server
- Fetch top stories from specific NYT sections
- Search for articles by query and sort order
- Retrieve real-time news updates via Times Wire
- Access bestseller lists through the Books API
- Archive retrieval by year and month
FAQ from NYT MCP Server
What APIs does NYT MCP Server support?
It supports Article Search, Top Stories, Times Wire, Most Popular, Archive, and Books API.
How do I get a New York Times API key?
Visit the NYT Developer Portal to obtain a free API key.
What are the runtime requirements?
Python 3.8+ and a valid NYT API key are required. All other dependencies are listed in requirements.txt.
How do I start the MCP server?
Create a .env file with NYT_API_KEY, MCP_PORT, and MCP_HOST variables, then run python src/server.py from the project root.
What message types are available for the /mcp/message endpoint?
You can use article_search, top_stories, times_wire, most_popular, archive, and books as message_type values.
