{"openapi":"3.1.0","info":{"title":"Wheel Size (BYOK) API","version":"0.1.0","description":"Wheel Size (BYOK) lets an AI assistant read your own Wheel Size data through the Wheel Size API with a key you supply (Wheel Size API user key). Read-only: 7 tools (list_makes, list_models, list_years, list_generations, list_modifications, list_regions, search_by_vehicle). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-wheelsize.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-wheelsize/docs"},"termsOfService":"https://connectorbay.com/byok-wheelsize/terms"},"servers":[{"url":"https://byok-wheelsize.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-wheelsize/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_makes":{"post":{"operationId":"list_makes","summary":"List vehicle manufacturers with slug, name and the regions where they are sold, optionally for one model year or region.","description":"List vehicle manufacturers with slug, name and the regions where they are sold, optionally for one model year or region. Use for \"Which car makes does the database cover for Europe\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"year":{"anyOf":[{"maximum":2030,"minimum":1950,"type":"integer"},{"type":"null"}],"default":null,"description":"Model year, for example 2020.","title":"Year"},"region":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Market region slug such as usdm, eudm or jdm (list_regions gives all). One region only.","title":"Region"}},"title":"list_makesArguments","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/list_models":{"post":{"operationId":"list_models","summary":"List models of a make with slug, name, production year ranges and regions. Use for \"Which Toyota models exist in the dat","description":"List models of a make with slug, name, production year ranges and regions. Use for \"Which Toyota models exist in the database\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"make":{"description":"Make slug such as toyota.","maxLength":200,"title":"Make","type":"string"},"year":{"anyOf":[{"maximum":2030,"minimum":1950,"type":"integer"},{"type":"null"}],"default":null,"description":"Model year, for example 2020.","title":"Year"},"region":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Market region slug such as usdm, eudm or jdm (list_regions gives all). One region only.","title":"Region"}},"required":["make"],"title":"list_modelsArguments","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/list_years":{"post":{"operationId":"list_years","summary":"List model years available, optionally for one make and model. Use for \"Which model years of the Toyota Camry are covere","description":"List model years available, optionally for one make and model. Use for \"Which model years of the Toyota Camry are covered\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"make":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Make slug such as toyota.","title":"Make"},"model":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Model slug such as camry.","title":"Model"},"region":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Market region slug such as usdm, eudm or jdm (list_regions gives all). One region only.","title":"Region"}},"title":"list_yearsArguments","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/list_generations":{"post":{"operationId":"list_generations","summary":"List generations of a make and model with platform code, production span, body types, regions and years. Use for \"What g","description":"List generations of a make and model with platform code, production span, body types, regions and years. Use for \"What generations of the BMW 3 Series are there\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"make":{"description":"Make slug such as toyota or land-rover (list_makes gives valid slugs).","maxLength":200,"title":"Make","type":"string"},"model":{"description":"Model slug such as camry or 3-series (list_models gives valid slugs).","maxLength":200,"title":"Model","type":"string"},"year":{"anyOf":[{"maximum":2030,"minimum":1950,"type":"integer"},{"type":"null"}],"default":null,"description":"Model year, for example 2020.","title":"Year"},"region":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Market region slug such as usdm, eudm or jdm (list_regions gives all). One region only.","title":"Region"}},"required":["make","model"],"title":"list_generationsArguments","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/list_modifications":{"post":{"operationId":"list_modifications","summary":"List trims (modifications) of a vehicle with engine, powertrain, body and production years; give a year or a generation.","description":"List trims (modifications) of a vehicle with engine, powertrain, body and production years; give a year or a generation. Filters by fuel code, trim level and horsepower. Use for \"Which trims of the 2020 Toyota Camry are there\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"make":{"description":"Make slug such as toyota or land-rover (list_makes gives valid slugs).","maxLength":200,"title":"Make","type":"string"},"model":{"description":"Model slug such as camry or 3-series (list_models gives valid slugs).","maxLength":200,"title":"Model","type":"string"},"year":{"anyOf":[{"maximum":2030,"minimum":1950,"type":"integer"},{"type":"null"}],"default":null,"description":"Model year, for example 2020.","title":"Year"},"generation":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Generation slug from list_generations (alternative to year).","title":"Generation"},"region":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Market region slug such as usdm, eudm or jdm (list_regions gives all). One region only.","title":"Region"},"fuel":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Fuel code: petrol, diesel, electric, hybrid, lpg, cng, h2, flex_fuel, ethanol_blend, biodiesel_blend, e100, petrol_cng or petrol_lpg.","title":"Fuel"},"trim_level":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Case-insensitive trim level such as Touring or Sport.","title":"Trim Level"},"horsepower_min":{"anyOf":[{"maximum":2000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Minimum horsepower of the headline engine figure.","title":"Horsepower Min"},"horsepower_max":{"anyOf":[{"maximum":2000,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"Maximum horsepower of the headline engine figure.","title":"Horsepower Max"}},"required":["make","model"],"title":"list_modificationsArguments","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/list_regions":{"post":{"operationId":"list_regions","summary":"List the market regions of the database (for example usdm for USA, eudm for Europe, jdm for Japan) with slug, display na","description":"List the market regions of the database (for example usdm for USA, eudm for Europe, jdm for Japan) with slug, display name and abbreviation. Use for \"What market regions does the fitment database cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_regionsArguments","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/search_by_vehicle":{"post":{"operationId":"search_by_vehicle","summary":"Get factory wheel and tire fitment of a vehicle: bolt pattern, centre bore, torque, and for each wheel option rim size, ","description":"Get factory wheel and tire fitment of a vehicle: bolt pattern, centre bore, torque, and for each wheel option rim size, offset, tire size, load and speed index and pressure. Use only when the user asks for fitment; needs a modification or region, plus a year or generation (not needed with a modification). The provider requires such search calls to be started by a person. Use for \"What wheel and tire sizes fit a 2020 Toyota Camry in the US\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"make":{"description":"Make slug such as toyota or land-rover (list_makes gives valid slugs).","maxLength":200,"title":"Make","type":"string"},"model":{"description":"Model slug such as camry or 3-series (list_models gives valid slugs).","maxLength":200,"title":"Model","type":"string"},"year":{"anyOf":[{"maximum":2030,"minimum":1950,"type":"integer"},{"type":"null"}],"default":null,"description":"Model year, for example 2020.","title":"Year"},"generation":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Generation slug from list_generations (alternative to year).","title":"Generation"},"modification":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Modification slug from list_modifications.","title":"Modification"},"region":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Market region slug such as usdm, eudm or jdm (list_regions gives all). One region only.","title":"Region"},"limit":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"How many results to return (1 to 50).","title":"Limit"},"offset":{"anyOf":[{"maximum":100000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip.","title":"Offset"}},"required":["make","model"],"title":"search_by_vehicleArguments","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}}}}