{
  "openapi": "3.1.0",
  "info": {
    "title": "Onan Capital Inc Public Procurement & Supplier API",
    "version": "2026-11-01",
    "description": "Zero-authentication institutional PPE, safety, clinical, and facility supply catalog and RFQ intake API for Onan Capital Inc (SDVOSB · CAGE 827Y8 · UEI G8NFS5UCJ9F7 · NAICS 423450 · TIPS Contract 260804). Unit prices are never returned via API; formal quotes are issued by an account representative.",
    "contact": {
      "name": "Onan Capital Inc",
      "url": "https://www.onancap.com/contact",
      "email": "christopher.onan@onancap.com"
    },
    "x-versioning-policy": "URL versioning (/v1/ai/mcp) with API-Version header (2026-11-01).",
    "x-deprecation-policy": "Minimum 90-day advance notice via RFC 8594 Deprecation and Sunset headers documented at https://www.onancap.com/docs#versioning."
  },
  "servers": [
    {
      "url": "https://www.onancap.com",
      "description": "Production canonical endpoint"
    }
  ],
  "paths": {
    "/api/catalog": {
      "get": {
        "operationId": "getCatalog",
        "summary": "List institutional supply catalog",
        "description": "Returns all active Onan Capital supply SKUs, categories, and carton metadata without public unit pricing.",
        "responses": {
          "200": {
            "description": "Catalog JSON snapshot",
            "headers": {
              "RateLimit-Limit": { "schema": { "type": "integer", "example": 120 } },
              "RateLimit-Policy": { "schema": { "type": "string", "example": "120;w=60" } },
              "API-Version": { "schema": { "type": "string", "example": "2026-11-01" } }
            }
          },
          "405": {
            "description": "Method Not Allowed",
            "content": {
              "application/problem+json": {
                "schema": { "$ref": "#/components/schemas/ProblemDetails" }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded",
            "headers": {
              "Retry-After": { "schema": { "type": "integer" } }
            },
            "content": {
              "application/problem+json": {
                "schema": { "$ref": "#/components/schemas/ProblemDetails" }
              }
            }
          },
          "500": {
            "description": "Internal server error",
            "content": {
              "application/problem+json": {
                "schema": { "$ref": "#/components/schemas/ProblemDetails" }
              }
            }
          }
        }
      }
    },
    "/equivalents.json": {
      "get": {
        "operationId": "getSkuEquivalents",
        "summary": "List comparable industry buyer part numbers",
        "responses": {
          "200": {
            "description": "JSON list of comparable buyer references mapped to Onan SKUs"
          },
          "404": {
            "description": "Not found",
            "content": {
              "application/problem+json": {
                "schema": { "$ref": "#/components/schemas/ProblemDetails" }
              }
            }
          }
        }
      }
    },
    "/api/quote": {
      "post": {
        "operationId": "submitQuoteRequest",
        "summary": "Submit an institutional RFQ",
        "responses": {
          "200": {
            "description": "RFQ received and routed to desk"
          },
          "400": {
            "description": "Invalid request payload",
            "content": {
              "application/problem+json": {
                "schema": { "$ref": "#/components/schemas/ProblemDetails" }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded",
            "content": {
              "application/problem+json": {
                "schema": { "$ref": "#/components/schemas/ProblemDetails" }
              }
            }
          }
        }
      }
    },
    "/v1/ai/mcp": {
      "post": {
        "operationId": "invokeMcpJsonRpc",
        "summary": "Stateless Streamable HTTP MCP JSON-RPC 2.0 endpoint",
        "description": "Supports initialize, tools/list, and tools/call for get_supplier_profile, check_cooperative_eligibility, search_supplies, get_catalog_summary, audit_safety_expirations, and submit_rfq.",
        "responses": {
          "200": {
            "description": "JSON-RPC 2.0 MCP response"
          },
          "400": {
            "description": "Malformed JSON-RPC request",
            "content": {
              "application/problem+json": {
                "schema": { "$ref": "#/components/schemas/ProblemDetails" }
              }
            }
          },
          "405": {
            "description": "Method Not Allowed",
            "content": {
              "application/problem+json": {
                "schema": { "$ref": "#/components/schemas/ProblemDetails" }
              }
            }
          },
          "429": {
            "description": "Rate limit exceeded",
            "content": {
              "application/problem+json": {
                "schema": { "$ref": "#/components/schemas/ProblemDetails" }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "ProblemDetails": {
        "type": "object",
        "required": ["type", "title", "status", "code", "detail"],
        "properties": {
          "type": { "type": "string", "format": "uri" },
          "title": { "type": "string" },
          "status": { "type": "integer" },
          "code": { "type": "string" },
          "detail": { "type": "string" },
          "resolution": { "type": "string" },
          "docs": { "type": "string", "format": "uri" }
        }
      }
    }
  }
}
