openapi: 3.1.0
info:
  title: Dewey Feeds MCP API
  version: '0.1'
  summary: FastMCP server exposing read-only search over the Inquirer archive.
  description: Dewey MCP is a containerized FastMCP server for read-only search over a news archive backed by Azure AI Search. It exposes a single MCP tool, `search_archive`, that accepts a search query plus optional date and author filters and returns ranked article chunks with metadata. The server is open source under `phillymedia/dewey-mcp` and is the protocol surface for the broader Dewey AI librarian project (Lenfest Institute fellowship, supported by Microsoft and OpenAI). This OpenAPI describes the server's HTTP envelope (MCP protocol endpoint, liveness, and readiness probes); the MCP tool itself is described in `components.schemas`.
  contact:
    name: Dewey MCP
    url: https://github.com/phillymedia/dewey-mcp
servers:
- url: http://127.0.0.1:8000
  description: Default local server (configurable via MCP_HOST and MCP_PORT)
tags:
- name: MCP
  description: Model Context Protocol surface.
paths:
  /mcp:
    post:
      operationId: postMcp
      summary: Invoke MCP Protocol
      description: MCP protocol endpoint. Path is configurable via `MCP_PATH` (default `/mcp`). Exposes the `search_archive` tool.
      tags:
      - MCP
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: MCP JSON-RPC envelope.
      responses:
        '200':
          description: MCP JSON-RPC response envelope.
          content:
            application/json:
              schema:
                type: object