{"openapi":"3.1.0","info":{"title":"Slab API","version":"0.1.0","description":"A fully local DIY concrete and masonry calculator and reference: slab/footing/column volume calculators, a bag-count estimator, mix-ratio guidance by strength class, curing-time guidance, rebar spacing basics (with a structural-engineer disclaimer), weather-pouring considerations, and a masonry glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://slab.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/slab/docs"},"termsOfService":"https://connectorbay.com/slab/terms"},"servers":[{"url":"https://slab.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/slab/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/slab_volume_calculator":{"post":{"operationId":"slab_volume_calculator","summary":"Real geometry for a rectangular slab: area (length x width) times thickness, converted to cubic feet","description":"Real geometry for a rectangular slab: area (length x width) times thickness, converted to cubic feet\n    and cubic yards. Use for \"how many cubic yards for a 10x10 slab at 4 inches thick\", \"volume of a 20 by\n    30 foot driveway at 5 inches\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"length_ft":{"description":"Slab length, in feet.","exclusiveMinimum":0,"maximum":1000,"title":"Length Ft","type":"number"},"width_ft":{"description":"Slab width, in feet.","exclusiveMinimum":0,"maximum":1000,"title":"Width Ft","type":"number"},"thickness_in":{"description":"Slab thickness, in inches (e.g. 4 for a typical patio/walkway slab).","exclusiveMinimum":0,"maximum":48,"title":"Thickness In","type":"number"}},"required":["length_ft","width_ft","thickness_in"],"title":"slab_volume_calculatorArguments","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/footing_volume_calculator":{"post":{"operationId":"footing_volume_calculator","summary":"Real geometry for a strip or pad footing, or a square/rectangular column or pier: length x width x","description":"Real geometry for a strip or pad footing, or a square/rectangular column or pier: length x width x\n    depth, converted to cubic feet and cubic yards (the same L x W x H math covers all three — a column is\n    just a tall, narrow footing). For a round column or pier (e.g. a cylindrical Sonotube form), the volume\n    formula is pi x radius^2 x height instead — see masonry_glossary's \"Footing\" entry. Use for \"volume of a\n    footing 30 feet long, 18 inches wide, 12 inches deep\", \"concrete for a 12 by 12 inch, 4 foot tall pier\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"length_ft":{"description":"Length, in feet (for a square/rectangular column or pier, use its footprint length).","exclusiveMinimum":0,"maximum":1000,"title":"Length Ft","type":"number"},"width_ft":{"description":"Width, in feet (for a square column, the same as length_ft).","exclusiveMinimum":0,"maximum":20,"title":"Width Ft","type":"number"},"depth_in":{"description":"Depth in inches for a footing, or height in inches for a column/pier.","exclusiveMinimum":0,"maximum":1200,"title":"Depth In","type":"number"}},"required":["length_ft","width_ft","depth_in"],"title":"footing_volume_calculatorArguments","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/bag_count_estimator":{"post":{"operationId":"bag_count_estimator","summary":"How many pre-mixed concrete bags (40, 60, or 80 lb) are needed for a target cubic-yard volume, using","description":"How many pre-mixed concrete bags (40, 60, or 80 lb) are needed for a target cubic-yard volume, using\n    each bag's published cubic-foot yield (0.30 / 0.45 / 0.60 cu ft respectively), plus a 10% waste\n    allowance rounded up to a whole bag. Use for \"how many 80 lb bags of concrete for 1 cubic yard\", \"bags\n    of 60 lb concrete mix for 0.5 cubic yards\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cubic_yards":{"description":"Target volume in cubic yards (e.g. from slab_volume_calculator).","exclusiveMinimum":0,"maximum":100,"title":"Cubic Yards","type":"number"},"bag_size_lb":{"default":80,"description":"Bag size: 40, 60, or 80 lb.","title":"Bag Size Lb","type":"integer"}},"required":["cubic_yards"],"title":"bag_count_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/mix_ratio_guide":{"post":{"operationId":"mix_ratio_guide","summary":"Standard cement:sand:aggregate volumetric mix ratios by nominal strength grade, from lean fill","description":"Standard cement:sand:aggregate volumetric mix ratios by nominal strength grade, from lean fill\n    (~725 psi, 1:5:10) up to higher-strength structural mixes (~3625 psi, 1:1:2). Pass a target PSI to get\n    the closest standard grade, or omit it to see the whole table. Use for \"what's a 3000 psi concrete mix\n    ratio\", \"cement sand gravel ratio for a driveway\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"psi_target":{"anyOf":[{"exclusiveMinimum":0,"maximum":10000,"type":"number"},{"type":"null"}],"default":null,"description":"A target compressive strength in PSI; omit for the full table of standard grades.","title":"Psi Target"}},"title":"mix_ratio_guideArguments","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/curing_time_guide":{"post":{"operationId":"curing_time_guide","summary":"How long fresh concrete typically needs before it's safe to walk on (24-48 hours), drive on","description":"How long fresh concrete typically needs before it's safe to walk on (24-48 hours), drive on\n    (~7 days), have non-load-bearing formwork stripped (24-48 hours), or reach its 28-day design strength.\n    Use for \"how long before I can walk on new concrete\", \"when can I drive on a new driveway\", \"how long\n    until concrete is fully cured\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"application":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A stage to look up, e.g. 'walk', 'drive', 'formwork', 'full strength'. Omit for every stage.","title":"Application"}},"title":"curing_time_guideArguments","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/rebar_spacing_guide":{"post":{"operationId":"rebar_spacing_guide","summary":"General, illustrative rebar/reinforcement spacing by application (slabs, footings, foundation walls,","description":"General, illustrative rebar/reinforcement spacing by application (slabs, footings, foundation walls,\n    columns, sidewalks) — reference only. Every response carries an explicit disclaimer that real spacing\n    for load-bearing or permitted work must come from a structural engineer and/or local building code, not\n    this rule-of-thumb data. Use for \"how far apart should rebar be in a slab\", \"rebar spacing for a\n    footing\" — always pair the answer with the engineer/code disclaimer.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"application":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"An application, e.g. 'slab', 'footing', 'foundation wall', 'column', 'sidewalk'. Omit for every application.","title":"Application"}},"title":"rebar_spacing_guideArguments","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/weather_considerations_guide":{"post":{"operationId":"weather_considerations_guide","summary":"Hot-weather (fast evaporation, plastic shrinkage cracking, shortened working time) and cold-weather","description":"Hot-weather (fast evaporation, plastic shrinkage cracking, shortened working time) and cold-weather\n    (freeze damage before ~500 psi, hydration slowing below ~50°F) concrete-pouring considerations and\n    precautions. Use for \"can I pour concrete when it's freezing\", \"how do I keep concrete from cracking in\n    hot weather\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"weather_considerations_guideArguments","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/masonry_glossary":{"post":{"operationId":"masonry_glossary","summary":"Definitions of common concrete/masonry terms: rebar, formwork, aggregate, slump, curing, PSI,","description":"Definitions of common concrete/masonry terms: rebar, formwork, aggregate, slump, curing, PSI,\n    Portland cement, mortar, footing, control joint, vapor barrier, efflorescence, air entrainment. Use for\n    \"what does slump mean\", \"what's the difference between cement and concrete\".","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":"masonry_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/search":{"post":{"operationId":"search","summary":"Full-text search across Slab's own bundled reference content — mix ratios, curing stages, rebar","description":"Full-text search across Slab's own bundled reference content — mix ratios, curing stages, rebar\n    spacing entries, weather guidance, and glossary terms — for a keyword or phrase. Purely local, not a web\n    search. Use for \"search slab for slump\", \"find anything about driveways\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"A keyword or phrase to search this connector's own reference content.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"searchArguments","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}}}}