{"openapi":"3.1.0","info":{"title":"Tradecert API","version":"0.1.0","description":"A fully local skilled-trade certification/licensing-pathway reference: apprentice-to-journeyman-to-master pathway overviews for electrician, plumber, HVAC, and welding, a trade-school-vs-apprenticeship comparison, continuing-education/renewal concepts, an hour-requirement-to-years estimator, a trade comparison table, and a glossary. General US reference, not legal or licensing advice.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://tradecert.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/tradecert/docs"},"termsOfService":"https://connectorbay.com/tradecert/terms"},"servers":[{"url":"https://tradecert.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/tradecert/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/trade_pathway_overview":{"post":{"operationId":"trade_pathway_overview","summary":"The apprentice -> journeyman -> master progression for a common US skilled trade: typical","description":"The apprentice -> journeyman -> master progression for a common US skilled trade: typical\n    apprenticeship length, approximate OJT/classroom hour ranges, and one notable real certification/code.\n    Use for \"what's the path to becoming a licensed electrician\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"trade":{"description":"electrician | plumber | hvac | welding","minLength":1,"title":"Trade","type":"string"}},"required":["trade"],"title":"trade_pathway_overviewArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/trade_school_vs_apprenticeship_comparison":{"post":{"operationId":"trade_school_vs_apprenticeship_comparison","summary":"General cost/time/structure tradeoffs between attending trade school first versus entering a paid","description":"General cost/time/structure tradeoffs between attending trade school first versus entering a paid\n    apprenticeship directly. Use for \"trade school or apprenticeship for HVAC — which is better\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"trade_school_vs_apprenticeship_comparisonArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/continuing_education_renewal_overview":{"post":{"operationId":"continuing_education_renewal_overview","summary":"General license-renewal concepts: typical renewal cycles, continuing-education hour requirements,","description":"General license-renewal concepts: typical renewal cycles, continuing-education hour requirements,\n    renewal fees, and reciprocity, with a trade-specific note when a trade is given. Use for \"how often do I\n    need to renew my electrician license\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"trade":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional: electrician | plumber | hvac | welding, for a trade-specific note.","title":"Trade"}},"title":"continuing_education_renewal_overviewArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/license_levels_glossary":{"post":{"operationId":"license_levels_glossary","summary":"Definitions of common skilled-trade licensing terms: apprentice, journeyman, master, OJT hours,","description":"Definitions of common skilled-trade licensing terms: apprentice, journeyman, master, OJT hours,\n    related instruction hours, JATC, reciprocity, continuing education, journeyman exam. Use for \"what does\n    journeyman mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A term to define, or omit for the full glossary.","title":"Term"}},"title":"license_levels_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/hour_requirement_estimator":{"post":{"operationId":"hour_requirement_estimator","summary":"Rough estimate of years to complete a trade's typical apprenticeship OJT-hour requirement at a given","description":"Rough estimate of years to complete a trade's typical apprenticeship OJT-hour requirement at a given\n    weekly hour commitment. Use for \"how many years would a welding apprenticeship take at 30 hours a\n    week\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"trade":{"description":"electrician | plumber | hvac | welding","minLength":1,"title":"Trade","type":"string"},"hours_per_week":{"description":"Hypothetical weekly hour commitment.","exclusiveMinimum":0,"maximum":80,"title":"Hours Per Week","type":"number"}},"required":["trade","hours_per_week"],"title":"hour_requirement_estimatorArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/trade_comparison_table":{"post":{"operationId":"trade_comparison_table","summary":"A side-by-side comparison of electrician, plumber, HVAC technician, and welder: typical apprenticeship","description":"A side-by-side comparison of electrician, plumber, HVAC technician, and welder: typical apprenticeship\n    length, OJT hour range, whether a state journeyman-style license is typical, and a notable certifying\n    body/code. Use for \"how do electrician, plumber, HVAC, and welding licensing compare\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"trade_comparison_tableArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}