{
  "openapi": "3.1.0",
  "info": {
    "title": "KozyrAI Agentic Discovery API",
    "version": "2.8.0",
    "description": "Read-only machine-readable discovery endpoints for autonomous AI agents, MCP clients, and search indexers exploring the KozyrAI production ecosystem.",
    "contact": {
      "name": "Alex Kozyr",
      "email": "alex@kozyrai.com",
      "url": "https://kozyrai.com"
    }
  },
  "servers": [
    {
      "url": "https://kozyrai.com",
      "description": "Production KozyrAI Digital Headquarters"
    }
  ],
  "paths": {
    "/.well-known/agent.json": {
      "get": {
        "operationId": "getAgentCard",
        "summary": "Retrieve the A2A Agent Card for KozyrAI",
        "responses": {
          "200": {
            "description": "A2A Agent Card JSON manifest"
          }
        }
      }
    },
    "/api/catalog.json": {
      "get": {
        "operationId": "getPortfolioCatalog",
        "summary": "Retrieve the structured catalog of all 20 KozyrAI production systems, architectures, and engagement services",
        "responses": {
          "200": {
            "description": "Structured JSON portfolio catalog"
          }
        }
      }
    },
    "/llms.txt": {
      "get": {
        "operationId": "getLlmsSummary",
        "summary": "Retrieve the concise Markdown summary of KozyrAI for LLM context windows",
        "responses": {
          "200": {
            "description": "Markdown summary document"
          }
        }
      }
    },
    "/llms-full.txt": {
      "get": {
        "operationId": "getLlmsFullDossier",
        "summary": "Retrieve the full architectural dossier of all 20 KozyrAI systems and Founding Manifesto tenets",
        "responses": {
          "200": {
            "description": "Comprehensive Markdown architectural dossier"
          }
        }
      }
    }
  }
}
