{
  "openapi": "3.1.0",
  "info": {
    "title": "Nexus Public Discovery API",
    "version": "1.1.0",
    "description": "Read-only product, operating-capability and AI discovery interfaces for the Nexus AdTech platform from Nexus Soft."
  },
  "servers": [
    {
      "url": "https://admin.nexus-soft.org"
    }
  ],
  "paths": {
    "/api/health": {
      "get": {
        "summary": "Service health",
        "responses": {
          "200": {
            "description": "API is available"
          }
        }
      }
    },
    "/api/ready": {
      "get": {
        "summary": "Service readiness",
        "responses": {
          "200": {
            "description": "API and MongoDB are ready to serve application traffic"
          },
          "500": {
            "description": "A required runtime dependency is unavailable"
          }
        }
      }
    },
    "/api/catalog": {
      "get": {
        "summary": "Nexus product, ad-format and operating-capability catalog",
        "responses": {
          "200": {
            "description": "Machine-readable products, advertising formats, traffic quality, feed and bid, partner, advertiser, contextual and custom-engineering knowledge"
          }
        }
      }
    },
    "/api/capabilities": {
      "get": {
        "summary": "Platform capability knowledge",
        "responses": {
          "200": {
            "description": "Products, advertising formats, operating capabilities, targeting, security and MCP capabilities"
          }
        }
      }
    },
    "/mcp": {
      "post": {
        "summary": "Streamable HTTP MCP endpoint",
        "description": "Initialize MCP sessions, discover tools, resources and prompts, and call approved Nexus discovery tools.",
        "responses": {
          "200": {
            "description": "MCP response or stream"
          }
        }
      }
    }
  }
}