{"openapi":"3.1.0","info":{"title":"Hive API","version":"0.1.0","description":"A hand-curated backyard beekeeping reference: hive type comparisons, bee breed profiles, the seasonal management calendar, colony health basics centered on the varroa mite, honey harvesting, equipment/PPE reference, and a beginner start-up guide — all local.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://hive.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/hive/docs"},"termsOfService":"https://connectorbay.com/hive/terms"},"servers":[{"url":"https://hive.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/hive/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/hive_type_info":{"post":{"operationId":"hive_type_info","summary":"Structure, pros/cons, and who each suits for the three common backyard hive types: Langstroth, top-bar","description":"Structure, pros/cons, and who each suits for the three common backyard hive types: Langstroth, top-bar\n    (Kenyan/Tanzanian), and Warré. Use for \"what's a top-bar hive\", \"pros and cons of a Langstroth hive\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A hive type.","examples":["langstroth","top-bar","warre"],"title":"Name","type":"string"}},"required":["name"],"title":"hive_type_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/bee_breed_info":{"post":{"operationId":"bee_breed_info","summary":"One honey bee breed/race's temperament, productivity, swarming tendency and common use. Use for \"are","description":"One honey bee breed/race's temperament, productivity, swarming tendency and common use. Use for \"are\n    Italian bees gentle\", \"what are Buckfast bees known for\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A honey bee breed/race.","examples":["italian","carniolan","buckfast"],"title":"Name","type":"string"}},"required":["name"],"title":"bee_breed_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/breed_search":{"post":{"operationId":"breed_search","summary":"Search the bee breeds in this guide by partial name or a trait keyword (e.g. \"cold climate\", \"gentle\",","description":"Search the bee breeds in this guide by partial name or a trait keyword (e.g. \"cold climate\", \"gentle\",\n    \"varroa resistant\"). Use for \"which bee breed is best for a cold climate\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"default":"","description":"Partial breed name or a trait keyword; empty lists all breeds.","title":"Query","type":"string"}},"title":"breed_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/seasonal_calendar_guide":{"post":{"operationId":"seasonal_calendar_guide","summary":"What a beekeeper does each season — spring buildup, summer management, fall preparation, winter survival —","description":"What a beekeeper does each season — spring buildup, summer management, fall preparation, winter survival —\n    or the full year at once. Use for \"what should I be doing with my bees right now\", \"how do I prepare a hive\n    for winter\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"spring | summer | fall | winter; omit for the full year.","title":"Season"}},"title":"seasonal_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/colony_health_guide":{"post":{"operationId":"colony_health_guide","summary":"General, non-diagnostic education on common colony-health topics — the varroa mite above all, plus nosema,","description":"General, non-diagnostic education on common colony-health topics — the varroa mite above all, plus nosema,\n    small hive beetle, wax moth, American foulbrood, queenlessness and robbing — always pointing to a local\n    extension office or experienced beekeeper for anything suspected in an actual hive. Never names a treatment\n    product or dose. Use for \"what is a varroa mite\", \"how do beekeepers check for mites\", \"what's American\n    foulbrood\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A colony-health topic, e.g. varroa mite, nosema, small hive beetle, wax moth, american foulbrood, queenlessness, robbing. Omit for varroa plus an overview of the rest.","title":"Topic"}},"title":"colony_health_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/honey_harvesting_guide":{"post":{"operationId":"honey_harvesting_guide","summary":"General honey-harvesting guidance: readiness signs (capped percentage, moisture/refractometer, the shake","description":"General honey-harvesting guidance: readiness signs (capped percentage, moisture/refractometer, the shake\n    test), timing, and the harvesting process for frame-based vs. fixed-comb hives. Use for \"how do I know when\n    to harvest honey\", \"how does honey extraction work\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"honey_harvesting_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/equipment_reference":{"post":{"operationId":"equipment_reference","summary":"Factual reference on common beekeeping equipment and PPE — smoker, hive tool, suit/veil/gloves, honey","description":"Factual reference on common beekeeping equipment and PPE — smoker, hive tool, suit/veil/gloves, honey\n    extractor, and other common gear. Use for \"what's a hive tool for\", \"do I need a full bee suit\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"item":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A piece of equipment, e.g. smoker, hive tool, suit/veil/gloves, extractor, bee brush, feeder, queen excluder, bee escape. Omit to list the core items.","title":"Item"}},"title":"equipment_referenceArguments","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/starting_a_hive_guide":{"post":{"operationId":"starting_a_hive_guide","summary":"General considerations for a beginner starting their first hive — checking local ordinances, time and","description":"General considerations for a beginner starting their first hive — checking local ordinances, time and\n    physical commitment, cost factors (no specific pricing), and good first steps. Use for \"what do I need to\n    start beekeeping\", \"is beekeeping allowed in my backyard\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"starting_a_hive_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/beekeeping_glossary":{"post":{"operationId":"beekeeping_glossary","summary":"Definitions of common beekeeping terms (queen excluder, brood box, super, propolis, nuc, swarm, and more).","description":"Definitions of common beekeeping terms (queen excluder, brood box, super, propolis, nuc, swarm, and more).\n    Use for \"what's a super\", \"what does propolis mean\".","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":"beekeeping_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}}}}