{"openapi":"3.1.0","info":{"title":"Timber API","version":"0.1.0","description":"A fully local woodworking reference and calculator toolkit: nominal lumber sizing, board-foot math, a wood species guide with Janka hardness, joinery and finish guides, an approximate wood-movement estimator, fastener guidance, a sanding grit progression, and a woodworking glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://timber.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/timber/docs"},"termsOfService":"https://connectorbay.com/timber/terms"},"servers":[{"url":"https://timber.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/timber/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/lumber_dimension_lookup":{"post":{"operationId":"lumber_dimension_lookup","summary":"The actual (dressed, surfaced-four-sides) dimensions of a standard nominal softwood lumber size — a","description":"The actual (dressed, surfaced-four-sides) dimensions of a standard nominal softwood lumber size — a\n    \"2x4\" is really 1.5in x 3.5in. Use for \"what size is a 2x4 actually\", \"actual dimensions of a 1x6\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"nominal_size":{"description":"A nominal softwood lumber size, e.g. 2x4, 1x6, 4x4.","examples":["2x4","1x8","4x4"],"title":"Nominal Size","type":"string"}},"required":["nominal_size"],"title":"lumber_dimension_lookupArguments","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/board_foot_calculator":{"post":{"operationId":"board_foot_calculator","summary":"Computes real board-foot volume: thickness_in x width_in x length_ft / 12, per piece and for the given","description":"Computes real board-foot volume: thickness_in x width_in x length_ft / 12, per piece and for the given\n    quantity. Use for \"how many board feet is a 4/4 board 6in wide and 8ft long\", \"board feet for 10 pieces of\n    8/4 walnut, 10in wide, 6ft long\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"thickness_in":{"description":"Board thickness in inches, e.g. 0.75 or 1 for 4/4 hardwood.","exclusiveMinimum":0,"maximum":48,"title":"Thickness In","type":"number"},"width_in":{"description":"Board width in inches.","exclusiveMinimum":0,"maximum":200,"title":"Width In","type":"number"},"length_ft":{"description":"Board length in feet.","exclusiveMinimum":0,"maximum":100,"title":"Length Ft","type":"number"},"quantity":{"default":1,"description":"Number of identical boards.","maximum":100000,"minimum":1,"title":"Quantity","type":"integer"}},"required":["thickness_in","width_in","length_ft"],"title":"board_foot_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/wood_species_guide":{"post":{"operationId":"wood_species_guide","summary":"Janka hardness rating, common uses, workability notes, and a relative cost tier for a woodworking","description":"Janka hardness rating, common uses, workability notes, and a relative cost tier for a woodworking\n    species (24 common species covered). Use for \"how hard is hickory\", \"what's walnut good for\", \"is padauk\n    expensive\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A wood species name, e.g. oak, maple, walnut, padauk. Omit to list all.","title":"Name"}},"title":"wood_species_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/joinery_guide":{"post":{"operationId":"joinery_guide","summary":"Description, relative strength, typical use case, and difficulty level for a woodworking joint type (8","description":"Description, relative strength, typical use case, and difficulty level for a woodworking joint type (8\n    joints covered). Use for \"when should I use a dovetail vs a pocket screw\", \"how strong is a biscuit\n    joint\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A joint type, e.g. dovetail, mortise and tenon, pocket-hole, biscuit, dado, rabbet, box joint, dowel. Omit to list all.","title":"Name"}},"title":"joinery_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/finish_guide":{"post":{"operationId":"finish_guide","summary":"Application method, durability, look, and typical use case for a wood finish (7 finishes covered). Use","description":"Application method, durability, look, and typical use case for a wood finish (7 finishes covered). Use\n    for \"what finish for a cutting board\", \"how durable is shellac\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A wood finish, e.g. polyurethane, tung oil, boiled linseed oil, shellac, lacquer, paste wax, danish oil. Omit to list all.","title":"Name"}},"title":"finish_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/wood_movement_calculator":{"post":{"operationId":"wood_movement_calculator","summary":"An APPROXIMATE estimate of how much a board's width will expand or contract, using a published","description":"An APPROXIMATE estimate of how much a board's width will expand or contract, using a published\n    species dimensional-change-coefficient method. A real but approximate estimate for planning gaps and\n    seasonal wood movement, not an exact prediction. Use for \"how much will a 24in oak panel move with the\n    seasons\", \"will walnut move more than maple\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"width_in":{"description":"The board or panel's width across the grain, in inches.","exclusiveMinimum":0,"maximum":200,"title":"Width In","type":"number"},"species":{"description":"A wood species name, e.g. oak, walnut, maple.","title":"Species","type":"string"},"humidity_change_percent":{"description":"Approximate seasonal wood moisture-content swing, in percentage points (e.g. 4 for a typical indoor seasonal swing; negative for a decrease).","maximum":30,"minimum":-30,"title":"Humidity Change Percent","type":"number"}},"required":["width_in","species","humidity_change_percent"],"title":"wood_movement_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/fastener_guide":{"post":{"operationId":"fastener_guide","summary":"Recommended screw/nail/fastener types for a woodworking or building application. Use for \"what screws","description":"Recommended screw/nail/fastener types for a woodworking or building application. Use for \"what screws\n    for a deck ledger\", \"what fasteners for cabinet face frames\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"application":{"description":"framing | cabinetry | outdoor/exterior | trim | deck","title":"Application","type":"string"}},"required":["application"],"title":"fastener_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/sanding_grit_progression":{"post":{"operationId":"sanding_grit_progression","summary":"The standard sandpaper grit progression for finishing bare wood (e.g. 80 -> 120 -> 150 -> 220),","description":"The standard sandpaper grit progression for finishing bare wood (e.g. 80 -> 120 -> 150 -> 220),\n    optionally starting from a specified rough grit. Use for \"what grit should I start sanding at\", \"grit\n    sequence after 60 grit\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"starting_grit":{"anyOf":[{"maximum":1000,"minimum":24,"type":"integer"},{"type":"null"}],"default":null,"description":"A rough starting grit to build the sequence from, e.g. 60. Omit for the standard progression.","title":"Starting Grit"}},"title":"sanding_grit_progressionArguments","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/woodworking_glossary":{"post":{"operationId":"woodworking_glossary","summary":"Definitions of common woodworking terms (kerf, grain direction, quartersawn, plainsawn, MDF, warping,","description":"Definitions of common woodworking terms (kerf, grain direction, quartersawn, plainsawn, MDF, warping,\n    tearout, ...). Use for \"what does quartersawn mean\", \"what's tearout\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific woodworking term to look up; omit to list all.","title":"Term"}},"title":"woodworking_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}}}}