{"openapi":"3.1.0","info":{"title":"Trellis API","version":"0.1.0","description":"A fully local home viticulture and basic winemaking reference: grape variety guide, trellis/training systems, pruning calendar, a potential-alcohol calculator, soil/climate guidance, non-diagnostic pest and disease awareness, and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://trellis.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/trellis/docs"},"termsOfService":"https://connectorbay.com/trellis/terms"},"servers":[{"url":"https://trellis.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/trellis/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/grape_variety_info":{"post":{"operationId":"grape_variety_info","summary":"A grape variety's species, category (wine/table/dual-use), color, USDA hardiness-zone range, climate needs,","description":"A grape variety's species, category (wine/table/dual-use), color, USDA hardiness-zone range, climate needs,\n    characteristics and disease notes. Use for \"tell me about Concord grapes\", \"is Riesling cold-hardy\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A grape variety name.","examples":["Cabernet Sauvignon","Concord","Marquette","Thompson Seedless"],"title":"Name","type":"string"}},"required":["name"],"title":"grape_variety_infoArguments","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/variety_search":{"post":{"operationId":"variety_search","summary":"Search the grape varieties in this guide by partial name, species, category (wine/table/dual), or a trait","description":"Search the grape varieties in this guide by partial name, species, category (wine/table/dual), or a trait\n    mentioned in its notes. Use for \"what seedless table grapes do you have\", \"any muscadine info\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"default":"","description":"Partial variety name, species, category, or trait; empty lists all varieties.","title":"Query","type":"string"}},"title":"variety_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}},"/v1/tools/varieties_by_climate_zone":{"post":{"operationId":"varieties_by_climate_zone","summary":"Grape varieties whose general hardiness-zone range covers a given USDA zone -- general zone-adjacent","description":"Grape varieties whose general hardiness-zone range covers a given USDA zone -- general zone-adjacent\n    guidance, not a personalized planting recommendation. Use for \"what grapes can survive zone 4 winters\",\n    \"grapes for zone 8\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"zone":{"description":"A USDA hardiness zone, e.g. '5', '5b', or 'zone 7'.","title":"Zone","type":"string"}},"required":["zone"],"title":"varieties_by_climate_zoneArguments","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/trellis_system_guide":{"post":{"operationId":"trellis_system_guide","summary":"Real grapevine training/trellis systems -- Vertical Shoot Positioning (VSP), high-cordon (Lenz Moser),","description":"Real grapevine training/trellis systems -- Vertical Shoot Positioning (VSP), high-cordon (Lenz Moser),\n    Geneva Double Curtain, head training/gobelet, Guyot, Scott Henry, and Lyre -- what each looks like and what\n    kind of vine or site it suits. Use for \"what's VSP trellising\", \"what trellis system for a vigorous vine\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"system":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A training/trellis system, e.g. vsp, high_cordon, geneva_double_curtain, head_training, guyot, scott_henry, lyre. Omit to list all.","title":"System"}},"title":"trellis_system_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/pruning_calendar_guide":{"post":{"operationId":"pruning_calendar_guide","summary":"General grapevine pruning-timing guidance and principles, by season or for the whole year. Use for \"when","description":"General grapevine pruning-timing guidance and principles, by season or for the whole year. Use for \"when\n    should I prune my grapevines\", \"what do I do to my vines in summer\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"dormant_winter | early_spring | summer | post_harvest_fall; omit for all seasons plus general principles.","title":"Season"}},"title":"pruning_calendar_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/potential_alcohol_calculator":{"post":{"operationId":"potential_alcohol_calculator","summary":"Estimated potential alcohol from a single starting must reading (specific gravity or Brix), assuming","description":"Estimated potential alcohol from a single starting must reading (specific gravity or Brix), assuming\n    complete (\"dry\") fermentation, using the standard published formulas -- shows the math and notes it's an\n    estimate. Use for \"what's my potential alcohol from 22 Brix\", \"OG 1.090, what ABV could that reach\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"specific_gravity":{"anyOf":[{"maximum":1.2,"minimum":0.98,"type":"number"},{"type":"null"}],"default":null,"description":"A starting specific-gravity (hydrometer) reading, e.g. 1.090. Give this or brix, not both.","title":"Specific Gravity"},"brix":{"anyOf":[{"maximum":40,"minimum":0,"type":"number"},{"type":"null"}],"default":null,"description":"A starting degrees-Brix (refractometer) reading, e.g. 22.0. Give this or specific_gravity, not both.","title":"Brix"}},"title":"potential_alcohol_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/soil_and_climate_guide":{"post":{"operationId":"soil_and_climate_guide","summary":"General soil drainage/pH and climate/sunlight/rainfall requirements for growing grapes, plus what a USDA","description":"General soil drainage/pH and climate/sunlight/rainfall requirements for growing grapes, plus what a USDA\n    hardiness zone does and doesn't tell you. Use for \"what soil do grapevines need\", \"do grapes need full sun\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"soil_and_climate_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/pest_and_disease_awareness_guide":{"post":{"operationId":"pest_and_disease_awareness_guide","summary":"General, non-diagnostic awareness of common grape pests and diseases -- what they are and the conditions","description":"General, non-diagnostic awareness of common grape pests and diseases -- what they are and the conditions\n    that favor them -- always pointing to a local agricultural extension office for an actual active problem,\n    never a specific chemical treatment. Use for \"what is powdery mildew\", \"why is phylloxera historically\n    important\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"powdery_mildew | downy_mildew | black_rot | bunch_rot_botrytis | phylloxera | pierce_disease | birds_and_wildlife. Omit to list all.","title":"Topic"}},"title":"pest_and_disease_awareness_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/viticulture_glossary":{"post":{"operationId":"viticulture_glossary","summary":"Definitions of common viticulture and winemaking terms (Brix, veraison, cordon, cane, spur, must, racking,","description":"Definitions of common viticulture and winemaking terms (Brix, veraison, cordon, cane, spur, must, racking,\n    and more). Use for \"what does veraison mean\", \"what's a cordon\".","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":"viticulture_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}}}}