Timber

Timber — connector documentation

• MCP endpoint: https://timber.connectorbay.com/mcp
• REST API: POST https://timber.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://timber.connectorbay.com/openapi.json
• Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
• Authentication: none required. An optional Authorization: Bearer <key> raises rate limits.
• Health: https://timber.connectorbay.com/health · Tool schemas: https://timber.connectorbay.com/tools.json
• Publisher: Unify Dynamics LLC · connectorbay.com/timber · agent@connectorbay.com

What Timber is for

The reference and quick math every woodworking project needs — what a "2x4" actually measures, how many board feet a stack of hardwood comes to, how hard a species really is next to the one you were planning to use, which joint to reach for, which finish to put on a cutting board, how much a wide panel might move with the seasons — answered instantly, from one hand-curated, cross-checked toolbox.

What it does

Actual (dressed, S4S) dimensions for any standard nominal softwood lumber size from 1x2 through 2x12 and 4x4 (lumber_dimension_lookup); real board-foot volume from thickness, width, length and quantity (board_foot_calculator); a guide to 24 common woodworking species with Janka hardness rating, common uses, workability notes and a relative cost tier (wood_species_guide); a guide to 8 joinery methods — mortise and tenon, dovetail, pocket-hole, biscuit, dado, rabbet, box joint, dowel — with relative strength, typical use and difficulty (joinery_guide); a guide to 7 finishes — polyurethane, tung oil, boiled linseed oil, shellac, lacquer, paste wax, danish oil — with application method, durability, look and typical use (finish_guide); an approximate wood expansion/contraction estimate for a board's width, computed from a published species dimensional-change coefficient (wood_movement_calculator); recommended fasteners by application — framing, cabinetry, outdoor/exterior, trim, deck (fastener_guide); the standard sandpaper grit progression, optionally starting from a specified rough grit (sanding_grit_progression); and a glossary of common woodworking terms — kerf, grain direction, quartersawn, MDF, warping, tearout, and more (woodworking_glossary).

What it is not

Not a substitute for the actual board in your hands. Nominal lumber sizes, Janka ratings, and movement coefficients are cross-checked against publicly published references, but real lumber varies by mill, moisture content, and growing region — always measure your own stock rather than assume the nominal or reference figure. wood_movement_calculator is an approximate planning estimate using a real published method, not an exact prediction, and fastener_guide is general guidance, not a substitute for your local building code on structural connections like deck ledgers. Timber does not sell lumber, hardware, or finish products and has no affiliation with any lumber yard, mill, or brand named in its guides.

Tools

Lumber & Calculators

lumber_dimension_lookup — The actual (dressed, surfaced-four-sides) dimensions of a standard nominal softwood lumber size — a "2x4" is really 1.5in x 3.5in. Use for "what size is a 2x4 actually", "actual dimensions of a 1x6". Args: nominal_size.

board_foot_calculator — Computes real board-foot volume: thickness_in x width_in x length_ft / 12, per piece and for the given quantity. Use for "how many board feet is a 4/4 board 6in wide and 8ft long", "board feet for 10 pieces of 8/4 walnut, 10in wide, 6ft long". Args: thickness_in, width_in, length_ft, quantity.

wood_movement_calculator — An APPROXIMATE estimate of how much a board's width will expand or contract, using a published species dimensional-change-coefficient method. A real but approximate estimate for planning gaps and seasonal wood movement, not an exact prediction. Use for "how much will a 24in oak panel move with the seasons", "will walnut move more than maple". Args: width_in, species, humidity_change_percent.

Materials

wood_species_guide — Janka hardness rating, common uses, workability notes, and a relative cost tier for a woodworking species (24 common species covered). Use for "how hard is hickory", "what's walnut good for", "is padauk expensive". Args: name.

Technique

joinery_guide — Description, relative strength, typical use case, and difficulty level for a woodworking joint type (8 joints covered). Use for "when should I use a dovetail vs a pocket screw", "how strong is a biscuit joint". Args: name.

finish_guide — Application method, durability, look, and typical use case for a wood finish (7 finishes covered). Use for "what finish for a cutting board", "how durable is shellac". Args: name.

sanding_grit_progression — The standard sandpaper grit progression for finishing bare wood (e.g. 80 -> 120 -> 150 -> 220), optionally starting from a specified rough grit. Use for "what grit should I start sanding at", "grit sequence after 60 grit". Args: starting_grit.

Hardware

fastener_guide — Recommended screw/nail/fastener types for a woodworking or building application. Use for "what screws for a deck ledger", "what fasteners for cabinet face frames". Args: application.

Reference

woodworking_glossary — Definitions of common woodworking terms (kerf, grain direction, quartersawn, plainsawn, MDF, warping, tearout, ...). Use for "what does quartersawn mean", "what's tearout". Args: term.

Conventions

• Read-only. Every tool reads public data or computes; nothing is written anywhere and nothing about the user is stored.
• Result envelope. ok: true with data, or ok: false with a structured error (bad_input, not_found, upstream_error). degraded lists optional sources that were unreachable.
• Rate limits. Free tier 60 tool calls/minute and 300/day per user (keyed on the user identifier supplied by the host agent, else client IP); Pro keys raise this. Over-limit calls return HTTP 429 with Retry-After. initialize and tools/list are never counted.

Support

agent@connectorbay.com · connectorbay.com/timber/support

Timber — Privacy Policy

Effective 24 September 2026. Unify Dynamics LLC ("we", "us"), Menlo Park, California.

What Timber is. Timber is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf for a fully local woodworking reference and calculator toolkit: lumber sizing, board-foot math, a wood species guide, joinery and finish guides, a wood-movement estimator, fastener guidance, a sanding grit progression, and a woodworking glossary. You interact with your assistant; the assistant sends us only the arguments needed for that one lookup or calculation.

What we receive. The arguments of each tool call — a lumber size, a set of board dimensions, a species name, a joint or finish name, a fastener application, a starting grit, or a glossary term — the technical headers needed to serve the request (an IP address or a client identifier supplied by the assistant, and a Pro API key if you have one), and standard server logs.

Everything is answered from bundled reference data or computed on the spot, and nothing is stored. No request is forwarded to any third party — there is no upstream call at all, live or otherwise — and no query is logged in request bodies, recorded, or used to train anything.

What we do not receive or store. We do not receive your conversation with the assistant or your name, and we do not build a profile from your queries: each request is answered independently and nothing carries over between requests. Rate-limit counters (a client identifier and timestamps) are held in memory for at most 24 hours. Hosting-provider access logs, which contain IP addresses and request paths but not request bodies, are retained for up to 30 days for security and abuse prevention.

Sub-processors. None — the entire dataset is bundled with the server and every calculation runs locally. Hosting: Vercel (United States regions).

Legal bases and your rights. Our processing is necessary to provide the service you request through your assistant. Because we store no personal data beyond short-lived logs, requests to access, correct or delete personal data are usually satisfied automatically; you can still contact agent@connectorbay.com and we will respond within 30 days. We do not sell or share personal information and do not use your data to train models.

Children. Timber is a general-audience service operated by the adult using the assistant.

Changes. We will post changes here with a new effective date.

Timber — Terms of Service

Effective 24 September 2026. These terms govern use of the Timber connector ("the Service") operated by Unify Dynamics LLC ("we", "us").

1. The Service. Timber returns a fully local woodworking reference and calculator toolkit — nominal lumber sizing, board-foot math, a wood species guide, joinery and finish guides, a wood-movement estimate, fastener guidance, a sanding grit progression, and a woodworking glossary — from bundled reference data and on-the-spot computation. It is accessed through an AI assistant or directly over MCP or HTTP.
2. Reference and estimate, not a guarantee. Timber is an independent reference and calculator tool, not affiliated with or endorsed by any lumber yard, mill, hardware manufacturer, or finish brand. Its board-foot math is exact arithmetic; its wood-movement estimates, Janka ratings, cost tiers, and fastener guidance are general reference figures and approximations, not a substitute for measuring your own stock, a manufacturer's product instructions, or your local building code.
3. Not code or engineering advice. Nothing in the Service should be relied on as a substitute for a licensed engineer, a building inspector, or your local building code, particularly for structural connections such as deck ledgers or framing.
4. Acceptable use. Automated use within the published rate limits is welcome.
5. Availability. The Service is provided "as is" without warranty. We may change, limit or discontinue it at any time.
6. Data. Our Privacy Policy describes what we process. In short: your query is answered from bundled reference data or computed on the spot, and nothing is stored.
7. Pro keys. Optional Pro API keys are issued at our discretion, are personal to the holder and may be revoked for abuse.
8. Liability. To the fullest extent permitted by law, Unify Dynamics LLC is not liable for any loss arising from use of or reliance on the Service, including any loss from a materials, fastener, or structural decision made using its reference figures or estimates. Our total liability is limited to US $100.
9. Governing law. California law; venue in San Mateo County, California.
10. Contact. Unify Dynamics LLC · agent@connectorbay.com · https://connectorbay.com/timber

Timber support

Email agent@connectorbay.com. We answer within two business days.

• MCP endpoint: https://timber.connectorbay.com/mcp
• REST API: https://timber.connectorbay.com/openapi.json
• Live status: https://timber.connectorbay.com/health

When you report a problem, include the question you asked your agent, roughly when, and which agent you used (for example Claude, ChatGPT or Gemini). Never send us passwords, account numbers or ID numbers. Timber never asks for them.