{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "name": "CareerPath AI WebMCP Actions",
  "platform": "CareerPath AI Technologies Inc.",
  "version": "1.0.0",
  "description": "Standard WebMCP & Model Context Protocol agent actions specification for autonomous AI browsing agents (Chrome AI, Gemini, Claude Computer Use, Operator). Enables structured automation of career diagnostics, roadmap creation, job discovery, and credential verification.",
  "baseUrl": "https://careerpath-ai-bdbt.onrender.com",
  "docsUrl": "https://careerpath-ai-bdbt.onrender.com/llms.txt",
  "technicalSpecsUrl": "https://careerpath-ai-bdbt.onrender.com/llms-full.txt",
  "actions": [
    {
      "id": "start_diagnostic",
      "name": "Start Career Assessment Diagnostic",
      "description": "Initiates the 4-step comprehensive career diagnostic evaluating academic background, interests, and verified technical competencies across 24 industry streams.",
      "uiSelector": "#startAssessmentBtn, #startAssessmentNavBtn, #assessmentForm",
      "targetUrl": "/assessment.html",
      "method": "POST",
      "apiEndpoint": "/api/assessments/submit",
      "parameters": {
        "type": "object",
        "properties": {
          "stream": {
            "type": "string",
            "enum": ["engineering", "business", "design", "marketing"],
            "description": "Primary stream or career track"
          },
          "course": {
            "type": "string",
            "description": "Degree or program, e.g., 'BCA', 'B.Tech Computer Science', 'MCA'"
          },
          "branch": {
            "type": "string",
            "description": "Branch or major, e.g., 'Computer Science', 'Artificial Intelligence'"
          },
          "year": {
            "type": "string",
            "enum": ["First Year", "Second Year", "Third Year", "Final Year", "Recent Graduate"],
            "description": "Current academic year"
          },
          "college": {
            "type": "string",
            "description": "College or university institute name"
          },
          "interests": {
            "type": "array",
            "items": { "type": "string" },
            "description": "List of selected interest domains, e.g. ['Web Development', 'Problem Solving']"
          },
          "skills": {
            "type": "object",
            "additionalProperties": {
              "type": "string",
              "enum": ["Beginner", "Intermediate", "Advanced"]
            },
            "description": "Map of skill names and calibrated proficiency levels"
          },
          "careerGoals": {
            "type": "string",
            "description": "Primary career aspirations or learning milestone target"
          }
        },
        "required": ["stream", "course", "skills"]
      }
    },
    {
      "id": "verify_credential",
      "name": "Verify Issued Credential",
      "description": "Cryptographically verifies an anti-cheat proctored milestone completion credential against the immutable SHA-256 skill evidence registry.",
      "uiSelector": "#verifySearchForm",
      "targetUrl": "/verify.html",
      "method": "GET",
      "apiEndpoint": "/api/certificates/verify/:id",
      "parameters": {
        "type": "object",
        "properties": {
          "certificateId": {
            "type": "string",
            "description": "Unique certificate identifier to verify, e.g., 'CP-2026-DEMO' or 'CP-BCA-2025-9921'"
          }
        },
        "required": ["certificateId"]
      }
    },
    {
      "id": "get_recommendations",
      "name": "Get Matched Career Routes",
      "description": "Retrieves ranked career matches generated by the 60% skills, 25% interests, 15% academics deterministic scoring engine.",
      "uiSelector": "#realityCheckCallout",
      "targetUrl": "/recommendations.html",
      "method": "GET",
      "apiEndpoint": "/api/recommendations",
      "parameters": {
        "type": "object",
        "properties": {
          "includeSkillGap": {
            "type": "boolean",
            "default": true,
            "description": "Whether to return matched, developing, and missing skills breakdown"
          }
        }
      }
    },
    {
      "id": "generate_roadmap",
      "name": "Generate 4-Week Milestone Roadmap",
      "description": "Generates a structured, milestone-paced execution roadmap for a selected career target with weekly tasks and anti-cheat proctored tests.",
      "uiSelector": "#generateRoadmapBtn",
      "targetUrl": "/roadmap.html",
      "method": "POST",
      "apiEndpoint": "/api/roadmaps/generate",
      "parameters": {
        "type": "object",
        "properties": {
          "careerTitle": {
            "type": "string",
            "description": "Target career title, e.g., 'Full Stack Web Developer', 'AI/ML Engineer'"
          },
          "targetWeeks": {
            "type": "integer",
            "default": 4,
            "description": "Duration in weeks (typically 4 weeks)"
          }
        },
        "required": ["careerTitle"]
      }
    },
    {
      "id": "search_jobs",
      "name": "Search Verified Job Board",
      "description": "Filters direct employer job and internship openings matched with student skill scores and 1-click apply capabilities.",
      "uiSelector": "#filterCareerSlug, #filterWorkplace",
      "targetUrl": "/jobs.html",
      "method": "GET",
      "apiEndpoint": "/api/jobs",
      "parameters": {
        "type": "object",
        "properties": {
          "careerSlug": {
            "type": "string",
            "description": "Track filter, e.g. 'front-end-developer', 'ai-ml-engineer'"
          },
          "workplace": {
            "type": "string",
            "enum": ["remote", "hybrid", "on-site"],
            "description": "Workplace arrangement filter"
          }
        }
      }
    },
    {
      "id": "explore_careers",
      "name": "Explore Career Universe 3D",
      "description": "Navigates all 24 curated career disciplines with required skills, market demand indicators, and salary projections.",
      "uiSelector": "#careers, #heroCanvas",
      "targetUrl": "/index.html#careers",
      "method": "GET"
    }
  ]
}