API Evangelist overlay for Psychiatry for Children Article API

overlay: 1.0.0
info:
  title: API Evangelist overlay for Psychiatry for Children Article API
  version: 1.0.0
extends: ../openapi/_original/childpsychiatry-ai-openapi.yml
x-generated: '2026-11-03'
x-method: generated
x-source: https://childpsychiatry.ai/.well-known/mcp/server-card.json
x-rationale: >-
  The provider OpenAPI declares no security at all. The provider's MCP server card states
  transport.authentication "none" and the REST endpoints answer unauthenticated GETs, so this
  overlay makes the public status explicit and binds each REST operation to the MCP tool that
  backs it (from mcp/childpsychiatry-ai-tool-crosswalk.yml). The original spec is not mutated.
actions:
  - target: $
    description: Declare the API public (no authentication), per the provider server card.
    update:
      security: []
  - target: $.paths['/api/v1/articles/search'].get
    description: Bind to MCP tool search_articles.
    update:
      x-mcp-tool: search_articles
  - target: $.paths['/api/v1/articles'].get
    description: Bind to MCP tool list_articles.
    update:
      x-mcp-tool: list_articles
  - target: $.paths['/api/v1/articles/{slug}'].get
    description: Bind to MCP tools get_article and cite_article.
    update:
      x-mcp-tool: [get_article, cite_article]
  - target: $.paths['/api/mcp/v1'].post
    description: Point the MCP transport operation at its discovery documents.
    update:
      x-mcp-server-card: https://childpsychiatry.ai/.well-known/mcp/server-card.json
      x-mcp-tools: [search_articles, list_articles, get_article, cite_article, get_microsite_info, get_crisis_resources]