{
  "openapi": "3.1.0",
  "info": {
    "title": "auxfirst Public Discovery API",
    "version": "0.1.0",
    "description": "Public, read-only machine-readable discovery endpoints for auxfirst — capabilities, agent skills, MCP discovery card, and service metadata. These are static GET resources; auxfirst does not yet expose a transactional or authenticated API.",
    "contact": { "name": "auxfirst", "url": "https://auxfirst.com/index.html#contact" },
    "license": { "name": "CC BY 4.0", "url": "https://creativecommons.org/licenses/by/4.0/" }
  },
  "servers": [
    { "url": "https://auxfirst.com", "description": "Production origin" }
  ],
  "paths": {
    "/capabilities.json": {
      "get": {
        "summary": "Get auxfirst machine-readable capabilities",
        "description": "Returns the full catalogue of auxfirst services, engagements, frameworks, open-source resources, and industry packages, with named inputs and outputs per capability.",
        "operationId": "getCapabilities",
        "responses": {
          "200": {
            "description": "Capabilities document",
            "content": { "application/json": {} }
          }
        }
      }
    },
    "/.well-known/agent-skills/index.json": {
      "get": {
        "summary": "Get auxfirst agent skills index",
        "description": "Returns the index of auxfirst consulting services and frameworks, each with a hashed markdown skill description.",
        "operationId": "getAgentSkills",
        "responses": {
          "200": {
            "description": "Agent skills index",
            "content": { "application/json": {} }
          }
        }
      }
    },
    "/.well-known/mcp/server-card.json": {
      "get": {
        "summary": "Get auxfirst MCP discovery card",
        "description": "Returns the MCP discovery card. Resources-only; transports is intentionally empty (no live tool server yet).",
        "operationId": "getMcpServerCard",
        "responses": {
          "200": {
            "description": "MCP server card",
            "content": { "application/json": {} }
          }
        }
      }
    },
    "/.well-known/api-catalog": {
      "get": {
        "summary": "Get the API catalog linkset",
        "description": "RFC 9727-style API catalog pointing at service descriptions, docs, metadata, and status.",
        "operationId": "getApiCatalog",
        "responses": {
          "200": {
            "description": "Linkset document",
            "content": { "application/linkset+json": {} }
          }
        }
      }
    },
    "/api/health.json": {
      "get": {
        "summary": "Health endpoint",
        "description": "Static health status for the public discovery surface.",
        "operationId": "getHealth",
        "responses": {
          "200": {
            "description": "Health status",
            "content": { "application/json": {} }
          }
        }
      }
    }
  }
}