{
  "openapi": "3.1.0",
  "info": {
    "title": "Oshyn Tools MCP Catalog",
    "version": "1.0.0",
    "description": "Documentation catalog for Oshyn canonical MCP tools. These operations are exposed via MCP tools, not REST endpoints."
  },
  "paths": {
    "/catalog/request_reliability_report": {
      "post": {
        "operationId": "requestReliabilityReport",
        "summary": "Request a site reliability report",
        "x-mcp-tool-name": "request_reliability_report",
        "x-legacy-tool": "create_site_report",
        "x-workflow-tools": ["get_site_report_status", "prompt_oshyn_contact_request", "submit_oshyn_contact_request"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["siteUrl", "emailAddress"],
                "properties": {
                  "siteUrl": { "type": "string" },
                  "emailAddress": { "type": "string", "format": "email" }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "CanonicalToolEnvelope with ReliabilityReportData"
          }
        }
      }
    },
    "/catalog/request_discoverability_assessment": {
      "post": {
        "operationId": "requestDiscoverabilityAssessment",
        "summary": "Request an LLM brand discoverability assessment",
        "x-mcp-tool-name": "request_discoverability_assessment",
        "x-legacy-tool": "start_discoverability_assessment",
        "x-workflow-tools": ["discoverability_assessment_status", "get_discoverability_assessment"],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": ["brandOrUrl"],
                "properties": {
                  "brandOrUrl": { "type": "string" },
                  "contactEmail": { "type": "string", "format": "email" },
                  "contactName": { "type": "string" }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "CanonicalToolEnvelope with StartDiscoverabilityAssessmentResult"
          }
        }
      }
    },
    "/catalog/qualify_dxp_requirements": {
      "post": {
        "operationId": "qualifyDxpRequirements",
        "summary": "Start DXP/CMS requirements qualification session",
        "x-mcp-tool-name": "qualify_dxp_requirements",
        "x-legacy-tool": "match_me_with_a_dxp",
        "x-workflow-tools": ["start_dxp_guided_questionnaire", "start_dxp_open_ended_experience", "get_dxp_results"],
        "responses": {
          "200": {
            "description": "CanonicalToolEnvelope with QuestionnaireSessionData"
          }
        }
      }
    },
    "/catalog/estimate_dxp_investment": {
      "post": {
        "operationId": "estimateDxpInvestment",
        "summary": "Start DXP/digital investment budget estimation session",
        "x-mcp-tool-name": "estimate_dxp_investment",
        "x-legacy-tool": "estimate_budget",
        "x-workflow-tools": ["start_budget_guided_questionnaire", "start_budget_open_ended_experience", "get_budget_results"],
        "responses": {
          "200": {
            "description": "CanonicalToolEnvelope with QuestionnaireSessionData"
          }
        }
      }
    }
  }
}