home / mcp / most popular mcp server

Most Popular MCP Server

Provides access to the NYTimes most popular API via MCP with configurable transport and runtime options.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ag2-mcp-servers-most-popular-api": {
      "command": "python",
      "args": [
        "mcp_server/main.py",
        "stdio"
      ],
      "env": {
        "CONFIG": "{\"transport\": \"stdio\"}",
        "SECURITY": "YOUR_API_KEY",
        "CONFIG_PATH": "Path to a JSON configuration file (e.g., mcp_server/mcp_config.json)"
      }
    }
  }
}

You run an MCP server that exposes a modeled, open API for the NYTimes Most Popular data, enabling clients to query and interact through the MCP protocol while benefiting from a consistent, transport-agnostic interface.

How to use

You connect an MCP client to the server using the stdio transport by launching the server locally. The server acts as an adapter to the NYTimes Most Popular API specification, letting your application request data through MCP requests and receive structured responses. Start-and-use patterns include initializing via the provided configuration, then issuing queries that map to the underlying API endpoints. You can operate in other transports later if needed (such as server-sent events or HTTP streaming), but stdio is the primary out-of-the-box mode.

How to install

# Prerequisites
Python 3.9+
pip and uv

# 1. Clone the server repository
git clone <repository-url>
cd mcp_server

# 2. Install dependencies (dev mode)
pip install -e ".[dev]"

# Alternative (if using uv):
uv pip install --editable ".[dev]"

# 3. Start the MCP server in stdio mode
python mcp_server/main.py stdio

Additional notes

Configuration is managed through environment variables and a JSON config file. The server accepts a path to a config file via CONFIG_PATH or a direct JSON string via CONFIG. Security parameters can be supplied through SECURITY. These variables control how the MCP server loads its settings and protects access.

Available tools

start_stdio

Launch the MCP server in stdio mode using the Python entry point and the stdio transport, enabling local clients to connect via standard input/output.

transport_modes

List and utilize supported MCP transport modes such as stdio, sse, and streamable-http for client connections.