Softician Notary Exam Prep

List PassExamHQ's active exam-prep tracks -- state licensing exams across Notary, Real Estate Salesperson, Real Estate Broker, Driver, Commercial Driver (CDL), Motorcycle, and Boating, covering every U.S. state that has one. Call this first if you don't already know the examType for what someone is asking about (e.g. "Texas real estate" or "Florida boating license"). Optionally filter by kind and/or a 2-letter stateCode; call with no arguments to get category-level counts first.

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "description": "Optional category filter.",
      "enum": [
        "Notary",
        "Real Estate Salesperson",
        "Real Estate Broker",
        "Driver",
        "Commercial Driver (CDL)",
        "Motorcycle",
        "Boating"
      ]
    },
    "stateCode": {
      "type": "string",
      "description": "Optional 2-letter state filter, e.g. \"TX\", \"FL\"."
    }
  }
}

{
  "type": "object",
  "properties": {
    "totalActive": {
      "type": "integer"
    },
    "categoryCounts": {
      "type": "object",
      "description": "Active state count per category, only present on an unfiltered call."
    },
    "tracks": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "examType": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "stateCode": {
            "type": "string"
          },
          "shortName": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "examType",
          "kind",
          "stateCode",
          "shortName",
          "url"
        ]
      }
    }
  },
  "required": [
    "totalActive",
    "tracks"
  ]
}

Fetch a real practice question from one of PassExamHQ's exam tracks (see list_available_tracks for the full catalog -- state licensing exams across Notary, Real Estate Salesperson/Broker, Driver, CDL, Motorcycle, and Boating). Returns the question and its 4 answer choices (A-D) WITHOUT the correct answer -- call grade_practice_answer with the returned questionId once you have a response to check it and see the explanation.

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "description": "Optional topic to filter by, e.g. \"Fees\", \"Contracts\", \"Financing\". Omit for any topic."
    },
    "examType": {
      "type": "string",
      "description": "Which exam track. Use list_available_tracks to find the exact value for a given state/category (naming pattern is roughly {2-letter state}_{category}, e.g. \"tx_re_broker\", \"fl_notary\", \"ny_cdl\"). Defaults to the original California Notary Public track if omitted.",
      "default": "ca_notary"
    }
  }
}

{
  "type": "object",
  "properties": {
    "questionId": {
      "type": "string"
    },
    "examType": {
      "type": "string"
    },
    "topic": {
      "type": "string"
    },
    "question": {
      "type": "string"
    },
    "choices": {
      "type": "object",
      "properties": {
        "A": {
          "type": "string"
        },
        "B": {
          "type": "string"
        },
        "C": {
          "type": "string"
        },
        "D": {
          "type": "string"
        }
      },
      "required": [
        "A",
        "B",
        "C"
      ]
    },
    "trackUrl": {
      "type": "string",
      "description": "Link to this specific track's page on PassExamHQ."
    }
  },
  "required": [
    "questionId",
    "examType",
    "topic",
    "question",
    "choices",
    "trackUrl"
  ]
}

Grade a response to a practice question previously returned by get_sample_question, and return whether it was correct plus the official explanation.

{
  "type": "object",
  "properties": {
    "questionId": {
      "type": "string",
      "description": "The questionId returned by get_sample_question."
    },
    "response": {
      "type": "string",
      "enum": [
        "A",
        "B",
        "C",
        "D"
      ],
      "description": "The letter choice being graded."
    }
  },
  "required": [
    "questionId",
    "response"
  ]
}

{
  "type": "object",
  "properties": {
    "correct": {
      "type": "boolean"
    },
    "correctChoice": {
      "type": "string"
    },
    "explanation": {
      "type": "string"
    },
    "trackUrl": {
      "type": "string"
    }
  },
  "required": [
    "correct",
    "correctChoice",
    "explanation",
    "trackUrl"
  ]
}