openapi: 3.1.0
info:
  title: Dewey MCP Feeds Sitemaps 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: Sitemaps
  description: XML sitemaps and sitemap indexes.
paths:
  /arc/outboundfeeds/sitemap-index-2/:
    get:
      operationId: getSitemapIndex
      summary: Get Sitemap Index
      description: Returns a sitemap index listing daily child sitemaps for roughly two years of inquirer.com content.
      tags:
      - Sitemaps
      parameters:
      - $ref: '#/components/parameters/outputType'
      responses:
        '200':
          description: Sitemap index XML document.
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/SitemapIndex'
  /arc/outboundfeeds/sitemap/latest/:
    get:
      operationId: getLatestSitemap
      summary: Get Latest URL Sitemap
      description: Returns the most recent URL sitemap of articles.
      tags:
      - Sitemaps
      parameters:
      - $ref: '#/components/parameters/outputType'
      responses:
        '200':
          description: URL sitemap XML document.
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/UrlSet'
  /arc/outboundfeeds/sitemap/{date}/:
    get:
      operationId: getDailySitemap
      summary: Get Daily URL Sitemap
      description: Returns the URL sitemap for the specified calendar day.
      tags:
      - Sitemaps
      parameters:
      - name: date
        in: path
        required: true
        description: Calendar day in YYYY-MM-DD format.
        schema:
          type: string
          pattern: ^\d{4}-\d{2}-\d{2}$
          example: 2026-05-22
      - $ref: '#/components/parameters/outputType'
      responses:
        '200':
          description: URL sitemap XML document.
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/UrlSet'
        '404':
          description: No sitemap for the requested date.
  /arc/outboundfeeds/news-sitemap/:
    get:
      operationId: getNewsSitemap
      summary: Get Google News Sitemap
      description: Returns the Google News sitemap of the most recent Inquirer.com articles, using the sitemap-news namespace.
      tags:
      - Sitemaps
      parameters:
      - $ref: '#/components/parameters/outputType'
      responses:
        '200':
          description: Google News sitemap XML document.
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/NewsUrlSet'
  /arc/outboundfeeds/sitemap-author-page/:
    get:
      operationId: getAuthorSitemap
      summary: Get Author Sitemap
      description: Returns a sitemap of Inquirer.com author pages.
      tags:
      - Sitemaps
      responses:
        '200':
          description: Author URL sitemap XML document.
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/UrlSet'
  /arc/outboundfeeds/sitemap-restaurant-page/:
    get:
      operationId: getRestaurantSitemap
      summary: Get Restaurant Sitemap
      description: Returns a sitemap of Inquirer.com restaurant review and guide pages.
      tags:
      - Sitemaps
      responses:
        '200':
          description: Restaurant URL sitemap XML document.
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/UrlSet'
components:
  schemas:
    UrlSet:
      type: object
      description: A sitemap URL set.
      properties:
        urls:
          type: array
          items:
            $ref: '#/components/schemas/SitemapUrl'
    SitemapUrl:
      type: object
      properties:
        loc:
          type: string
          format: uri
        lastmod:
          type: string
          format: date-time
        changefreq:
          type: string
          enum:
          - always
          - hourly
          - daily
          - weekly
          - monthly
          - yearly
          - never
        priority:
          type: number
          minimum: 0
          maximum: 1
        image:
          type: object
          properties:
            loc:
              type: string
              format: uri
            caption:
              type: string
    NewsUrlSet:
      type: object
      description: A Google News sitemap URL set.
      properties:
        urls:
          type: array
          items:
            type: object
            properties:
              loc:
                type: string
                format: uri
              news:
                type: object
                properties:
                  publication:
                    type: object
                    properties:
                      name:
                        type: string
                        example: The Philadelphia Inquirer
                      language:
                        type: string
                        example: en
                  publication_date:
                    type: string
                    format: date-time
                  title:
                    type: string
    SitemapIndex:
      type: object
      description: A sitemap index pointing at child sitemaps.
      properties:
        sitemaps:
          type: array
          items:
            type: object
            properties:
              loc:
                type: string
                format: uri
              lastmod:
                type: string
                format: date
  parameters:
    outputType:
      name: outputType
      in: query
      required: false
      description: Output serialization. Must be `xml` for sitemaps.
      schema:
        type: string
        enum:
        - xml
        default: xml