{
  "schemaVersion": "2024-11-05",
  "name": "okc-hvac-calculator",
  "title": "OKC HVAC Calculator",
  "description": "Structured HVAC repair-or-replace decision support for Oklahoma City homeowners, powered by Covington Heat & Air. Educational decision support only — not a diagnosis.",
  "version": "1.0.0",
  "provider": {
    "name": "Covington Heat & Air",
    "url": "https://covingtonheatair.com"
  },
  "homepage": "https://okchvaccalculator.com",
  "endpoints": {
    "restApi": "https://okchvaccalculator.com/api/v1",
    "remoteMcp": "https://okchvaccalculator.com/api/mcp",
    "remoteMcpLegacy": "https://okchvaccalculator.com/mcp",
    "browserWebmcp": "https://okchvaccalculator.com/api/webmcp",
    "pageLevelWebmcp": "document.modelContext.registerTool() — registered on every page of https://okchvaccalculator.com",
    "discovery": "https://okchvaccalculator.com/.well-known/mcp.json",
    "openapi": "https://okchvaccalculator.com/openapi.json",
    "documentation": "https://okchvaccalculator.com/docs"
  },
  "transport": "JSON-RPC 2.0 over HTTP POST (initialize, tools/list, tools/call, ping)",
  "authentication": {
    "type": "apiKey",
    "header": "X-API-Key",
    "note": "Required only for protected write tools (lead / booking submission). All read and analysis tools are public."
  },
  "cors": "* (public REST and MCP endpoints)",
  "safety": "Mandatory safety hard-stops. Safety-critical inputs (gas smell, carbon-monoxide alarms/symptoms, soot/burn marks, electrical hazards) force an IMMEDIATE_SERVICE hard-stop and preserve urgent guidance. Educational decision support only: no diagnosis, no guarantees, and the tool never recommends delaying emergency services or a qualified on-site evaluation.",
  "disclaimer": "Estimates only. Final diagnosis, equipment recommendations, availability, and pricing require an on-site evaluation.",
  "tools": [
    {
      "name": "get_okc_hvac_business_info",
      "description": "Get business information for the OKC HVAC Calculator, powered by Covington Heat & Air (name, phone, email, website, service area).",
      "protected": false,
      "restFallback": { "method": "GET", "path": "/api/v1/business" }
    },
    {
      "name": "get_repair_or_replace_tool_info",
      "description": "Get metadata about the repair-or-replace decision tool: what it does, assumptions, thresholds, fees, and its input schema.",
      "protected": false,
      "restFallback": { "method": "GET", "path": "/api/v1/calculator/meta" }
    },
    {
      "name": "run_hvac_repair_or_replace_analysis",
      "description": "Run the repair-or-replace decision engine and return a recommendation (REPAIR, REPLACE, DEPENDS, or IMMEDIATE_SERVICE) with reasoning and a multi-year cost comparison. Estimates only. Final diagnosis, equipment recommendations, availability, and pricing require an on-site evaluation.",
      "protected": false,
      "restFallback": { "method": "POST", "path": "/api/v1/calculator/run" }
    },
    {
      "name": "search_hvac_decision_content",
      "description": "Search published HVAC insights articles by keyword, category, or author. Returns matching article summaries.",
      "protected": false,
      "restFallback": { "method": "GET", "path": "/api/v1/articles" }
    },
    {
      "name": "get_hvac_article",
      "description": "Get the full content of a single published HVAC insights article by its slug, including its direct answer and FAQ.",
      "protected": false,
      "restFallback": { "method": "GET", "path": "/api/v1/articles/{slug}" }
    },
    {
      "name": "get_okc_hvac_service_area",
      "description": "Get the Covington Heat & Air service area, and optionally check whether a given city or ZIP is covered.",
      "protected": false,
      "restFallback": { "method": "GET", "path": "/api/v1/service-area" }
    },
    {
      "name": "submit_covington_lead_request",
      "description": "Submit a lead (contact request) to Covington Heat & Air. Requires an API key and explicit user consent.",
      "protected": true,
      "restFallback": { "method": "POST", "path": "/api/v1/lead" }
    },
    {
      "name": "submit_covington_booking_request",
      "description": "Submit a booking (appointment) request to Covington Heat & Air. Requires an API key and explicit user consent.",
      "protected": true,
      "restFallback": { "method": "POST", "path": "/api/v1/booking-request" }
    }
  ]
}