{"openapi":"3.1.0","info":{"title":"Sizewise API","version":"0.1.0","description":"A fully local, hand-curated international size-conversion reference: shoe sizes (men's, women's, kids'), clothing sizes (women's, men's tops, men's bottoms, kids') and ring sizes, cross-checked across US/UK/EU/Japan/Italy.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://sizewise.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/sizewise/docs"},"termsOfService":"https://connectorbay.com/sizewise/terms"},"servers":[{"url":"https://sizewise.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/sizewise/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/convert_shoe_size":{"post":{"operationId":"convert_shoe_size","summary":"Converts one shoe size between US/UK/EU/Japan(cm) for men's, women's or kids' footwear. Omit system_to to","description":"Converts one shoe size between US/UK/EU/Japan(cm) for men's, women's or kids' footwear. Omit system_to to\n    get every system at once. Use for \"what's a men's US 10 in UK sizing\", \"convert women's EU 39 to US\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"Whose shoe: mens, womens, or kids.","examples":["mens","womens","kids"],"title":"Category","type":"string"},"system_from":{"description":"The size system the input is in.","examples":["US","UK","EU","JP"],"title":"System From","type":"string"},"size":{"anyOf":[{"type":"string"},{"type":"number"}],"description":"The size value in system_from.","examples":[9,"9.5","1Y"],"title":"Size"},"system_to":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"System to convert to; omit to get all systems at once.","title":"System To"}},"required":["category","system_from","size"],"title":"convert_shoe_sizeArguments","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/shoe_size_chart":{"post":{"operationId":"shoe_size_chart","summary":"The full US/UK/EU/Japan shoe size conversion table for men's, women's or kids' footwear. Use for \"show me","description":"The full US/UK/EU/Japan shoe size conversion table for men's, women's or kids' footwear. Use for \"show me\n    the full men's shoe size chart\", \"what sizes do you have for kids' shoes\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"Whose shoe: mens, womens, or kids.","title":"Category","type":"string"}},"required":["category"],"title":"shoe_size_chartArguments","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/foot_length_to_shoe_size":{"post":{"operationId":"foot_length_to_shoe_size","summary":"Suggests the closest shoe size across all systems for a measured foot length in cm. Use for \"my foot is","description":"Suggests the closest shoe size across all systems for a measured foot length in cm. Use for \"my foot is\n    26cm long, what size shoe is that\", \"convert 10.5 inch foot to shoe size\" (convert inches to cm first: cm =\n    inches × 2.54).","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"Whose shoe: mens, womens, or kids.","title":"Category","type":"string"},"length_cm":{"description":"Measured foot length in centimeters (heel to longest toe).","exclusiveMinimum":0,"maximum":40,"title":"Length Cm","type":"number"}},"required":["category","length_cm"],"title":"foot_length_to_shoe_sizeArguments","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/kids_shoe_size_by_age":{"post":{"operationId":"kids_shoe_size_by_age","summary":"A typical kids' shoe size for a given age in months (0-144, i.e. up to 12 years). Use for \"what shoe size","description":"A typical kids' shoe size for a given age in months (0-144, i.e. up to 12 years). Use for \"what shoe size\n    is a typical 3 year old\", \"shoe size for an 8 month old baby\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"age_months":{"description":"Child's age in months (e.g. 30 for 2.5 years).","maximum":144,"minimum":0,"title":"Age Months","type":"integer"}},"required":["age_months"],"title":"kids_shoe_size_by_ageArguments","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/convert_clothing_size":{"post":{"operationId":"convert_clothing_size","summary":"Converts one clothing size between US/UK/EU/Italy/Japan/alpha (women's), US/UK/EU/alpha/chest (men's","description":"Converts one clothing size between US/UK/EU/Italy/Japan/alpha (women's), US/UK/EU/alpha/chest (men's\n    tops), US-waist-inches/EU-waist-cm (men's bottoms), or US-age/EU (kids). Use for \"what's a women's US 8 in\n    UK sizing\", \"convert men's EU 50 shirt to US\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"Clothing category.","examples":["womens","mens_tops","mens_bottoms","kids"],"title":"Category","type":"string"},"system_from":{"description":"The size system/label the input is in.","examples":["US","UK","EU","IT","Alpha"],"title":"System From","type":"string"},"size":{"anyOf":[{"type":"string"},{"type":"number"}],"description":"The size value in system_from.","examples":[8,"M",40],"title":"Size"},"system_to":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"System to convert to; omit to get all systems at once.","title":"System To"}},"required":["category","system_from","size"],"title":"convert_clothing_sizeArguments","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/clothing_size_chart":{"post":{"operationId":"clothing_size_chart","summary":"The full clothing size conversion table for one category (womens, mens_tops, mens_bottoms, kids). Use for","description":"The full clothing size conversion table for one category (womens, mens_tops, mens_bottoms, kids). Use for\n    \"show me the women's clothing size chart\", \"what are men's shirt sizes in EU\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"description":"Clothing category.","examples":["womens","mens_tops","mens_bottoms","kids"],"title":"Category","type":"string"}},"required":["category"],"title":"clothing_size_chartArguments","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/convert_ring_size":{"post":{"operationId":"convert_ring_size","summary":"Converts one ring size between US/UK/EU/Japan and inner diameter/circumference in mm. Use for \"what's a","description":"Converts one ring size between US/UK/EU/Japan and inner diameter/circumference in mm. Use for \"what's a\n    US ring size 7 in UK sizing\", \"what ring size is 54mm circumference\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"system_from":{"description":"The size system the input is in.","examples":["US","UK","EU","JP","diameter_mm","circumference_mm"],"title":"System From","type":"string"},"size":{"anyOf":[{"type":"string"},{"type":"number"}],"description":"The size value in system_from.","examples":[7,"N1/2",17.3],"title":"Size"},"system_to":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"System to convert to; omit to get all systems at once.","title":"System To"}},"required":["system_from","size"],"title":"convert_ring_sizeArguments","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/ring_size_chart":{"post":{"operationId":"ring_size_chart","summary":"The full US/UK/EU/Japan/diameter/circumference ring size conversion table. Use for \"show me the full ring","description":"The full US/UK/EU/Japan/diameter/circumference ring size conversion table. Use for \"show me the full ring\n    size chart\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"ring_size_chartArguments","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/size_systems":{"post":{"operationId":"size_systems","summary":"Lists every size category (shoes, clothing, rings) and which sizing systems (US, UK, EU, etc.) this","description":"Lists every size category (shoes, clothing, rings) and which sizing systems (US, UK, EU, etc.) this\n    reference covers for each. Use for \"what size conversions can you do\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"size_systemsArguments","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}}}}