{"openapi":"3.1.0","info":{"title":"Slotcar API","version":"0.1.0","description":"A fully local, hand-curated slot car racing hobby reference: track scales (1:24, 1:32, 1:43, 1:64, HO), routed/sectional/digital/analog track types, car classes and chassis layouts, racing formats, maintenance tips, a space-based scale finder, a terminology glossary and beginner tips.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://slotcar.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/slotcar/docs"},"termsOfService":"https://connectorbay.com/slotcar/terms"},"servers":[{"url":"https://slotcar.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/slotcar/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/scale_info":{"post":{"operationId":"scale_info","summary":"Full detail on one slot car track scale: the model-to-real-car ratio, typical car length, common track","description":"Full detail on one slot car track scale: the model-to-real-car ratio, typical car length, common track\n    types and car classes raced in it, how much physical space it needs, and pros/cons. Omit `scale` to list\n    every scale this reference covers. Use for \"what is 1:32 scale\", \"how big is an HO slot car\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"scale":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A track scale name or alias; omit to list every scale.","examples":["1:32","1/24","HO","1:64"],"title":"Scale"}},"title":"scale_infoArguments","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/track_type_info":{"post":{"operationId":"track_type_info","summary":"Explains one slot car track construction or control type — routed, sectional, digital (lane-change),","description":"Explains one slot car track construction or control type — routed, sectional, digital (lane-change),\n    analog (fixed-lane), portable/home, commercial/rental, oval, or road course — including how it works and\n    its pros/cons. Omit `name` to list every type. Use for \"what's the difference between routed and sectional\n    track\", \"how does a digital lane-change track work\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A track type name or alias; omit to list every type.","examples":["routed","sectional","digital","analog"],"title":"Name"}},"title":"track_type_infoArguments","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/car_class_info":{"post":{"operationId":"car_class_info","summary":"Covers one slot car racing class or chassis style — GT/Sports Car, Prototype/LMP, Formula/Open-Wheel,","description":"Covers one slot car racing class or chassis style — GT/Sports Car, Prototype/LMP, Formula/Open-Wheel,\n    Touring Car, Rally, Stock Car/Oval, Wide-Pan drag & oval chassis, Vintage/Retro, or Flexi-Chassis —\n    including typical scales, chassis notes, magnet conventions and its appeal. Omit `name` to list every\n    class. Use for \"what is a flexi chassis class\", \"what scale are Formula slot cars usually\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A car class or chassis-style name or alias; omit to list every class.","examples":["GT","Formula","Rally","wide-pan"],"title":"Name"}},"title":"car_class_infoArguments","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/racing_format_info":{"post":{"operationId":"racing_format_info","summary":"Explains one slot car racing format — lap-count, timed, endurance, elimination/bracket, handicap,","description":"Explains one slot car racing format — lap-count, timed, endurance, elimination/bracket, handicap,\n    team/relay, league/points series, or time-trial qualifying — including how it works and what it's good\n    for. Omit `name` to list every format. Use for \"what's an endurance slot car race\", \"how does a bracket\n    race work\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A racing format name or alias; omit to list every format.","examples":["lap-count","endurance","elimination","time trial"],"title":"Name"}},"title":"racing_format_infoArguments","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/maintenance_tip":{"post":{"operationId":"maintenance_tip","summary":"A practical care/maintenance tip for one topic — braid & guide flag, gear mesh & lubrication, tire","description":"A practical care/maintenance tip for one topic — braid & guide flag, gear mesh & lubrication, tire\n    cleaning, axle & bushing care, body alignment, track cleaning, wiring, motor break-in, magnet tuning, or\n    controller care — with why it matters and how often to do it. Omit `topic` to list every topic. Use for\n    \"how do I clean slot car braid\", \"how often should I lube the gears\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A maintenance topic or keyword; omit to list every topic.","examples":["braid","gears","tires","track cleaning"],"title":"Topic"}},"title":"maintenance_tipArguments","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/term_glossary":{"post":{"operationId":"term_glossary","summary":"Definitions of common slot car terminology — braid, guide flag, deslot, marshal, lane change,","description":"Definitions of common slot car terminology — braid, guide flag, deslot, marshal, lane change,\n    anglewinder, sidewinder, inline, flexi chassis, wide-pan, traction magnet, RTR, OOTB, and more. Omit\n    `term` to list every term. Use for \"what does deslot mean\", \"what's the difference between sidewinder and\n    anglewinder\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"term_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/find_scale_for_space":{"post":{"operationId":"find_scale_for_space","summary":"Suggests 1-3 track scales suited to a stated amount of space, keyword-matched against each scale's","description":"Suggests 1-3 track scales suited to a stated amount of space, keyword-matched against each scale's\n    typical space needs. Use for \"what scale slot car fits in my apartment\", \"I have a dedicated garage, what\n    scale should I get\", \"best slot car scale for a dining table layout\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"space_description":{"description":"A plain-language description of the space available.","examples":["a small apartment","dedicated garage","dining table","spare bedroom"],"minLength":1,"title":"Space Description","type":"string"}},"required":["space_description"],"title":"find_scale_for_spaceArguments","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/beginner_tips":{"post":{"operationId":"beginner_tips","summary":"A curated shortlist of practical tips for someone starting the slot car racing hobby — car choice,","description":"A curated shortlist of practical tips for someone starting the slot car racing hobby — car choice,\n    driving technique, basic maintenance and club etiquette. Use for \"any tips for a slot car beginner\",\n    \"what should I know before my first race night\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"count":{"default":5,"description":"How many tips to return.","maximum":12,"minimum":1,"title":"Count","type":"integer"}},"title":"beginner_tipsArguments","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}}}}