{"openapi":"3.1.0","info":{"title":"Roost API","version":"0.1.0","description":"A hand-curated backyard poultry-keeping reference: chicken breeds, coop and run sizing, nesting/roosting guidance, flock health basics, egg-production info, and predator-proofing tips — all local.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://roost.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/roost/docs"},"termsOfService":"https://connectorbay.com/roost/terms"},"servers":[{"url":"https://roost.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/roost/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/breed_info":{"post":{"operationId":"breed_info","summary":"A chicken breed's characteristics: origin, size, egg color and production, temperament, broodiness,","description":"A chicken breed's characteristics: origin, size, egg color and production, temperament, broodiness,\n    cold/heat hardiness, and purpose category. Use for \"tell me about Wyandottes\", \"is a Brahma cold-hardy\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A chicken breed name.","examples":["Rhode Island Red","Silkie","Orpington"],"title":"Name","type":"string"}},"required":["name"],"title":"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 25+ chicken breeds in this guide by partial name, alias, origin, or trait keyword. Use for","description":"Search the 25+ chicken breeds in this guide by partial name, alias, origin, or trait keyword. Use for\n    \"do you have anything on Marans\", \"what breeds lay blue eggs\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"default":"","description":"Partial breed name or alias; 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/breeds_by_purpose":{"post":{"operationId":"breeds_by_purpose","summary":"Chicken breeds in a given purpose category — egg-laying, meat, dual-purpose, or ornamental/bantam. Use","description":"Chicken breeds in a given purpose category — egg-laying, meat, dual-purpose, or ornamental/bantam. Use\n    for \"what breeds are best for meat\", \"good dual-purpose breeds for a homestead\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"purpose":{"description":"egg-laying | meat | dual-purpose | ornamental","title":"Purpose","type":"string"}},"required":["purpose"],"title":"breeds_by_purposeArguments","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/coop_sizing_guide":{"post":{"operationId":"coop_sizing_guide","summary":"A real space-per-bird calculator for coop and run square footage, from cooperative-extension-style","description":"A real space-per-bird calculator for coop and run square footage, from cooperative-extension-style\n    backyard-flock housing guidance. Use for \"how big of a coop do I need for 6 chickens\", \"run size for a\n    dozen bantams\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"flock_size":{"description":"Number of birds to house.","maximum":1000,"minimum":1,"title":"Flock Size","type":"integer"},"size_class":{"default":"standard","description":"standard | bantam","title":"Size Class","type":"string"}},"required":["flock_size"],"title":"coop_sizing_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/nesting_and_roosting_guide":{"post":{"operationId":"nesting_and_roosting_guide","summary":"Nesting-box ratios and sizes, and roosting-bar space per bird, height, and placement. Use for \"how many","description":"Nesting-box ratios and sizes, and roosting-bar space per bird, height, and placement. Use for \"how many\n    nesting boxes do I need for 10 hens\", \"how much roost space per chicken\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"nesting_and_roosting_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/flock_health_guide":{"post":{"operationId":"flock_health_guide","summary":"Common, non-diagnostic flock wellness topics (molting, broodiness, parasites, heat/cold stress, pecking","description":"Common, non-diagnostic flock wellness topics (molting, broodiness, parasites, heat/cold stress, pecking\n    order, and more), with an explicit vet-consultation disclaimer on anything symptom-related. Not a diagnosis\n    tool. Use for \"is my hen okay if she's not laying\", \"what is bumblefoot\", \"how do I stop feather pecking\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A health/wellness topic, e.g. molting, broodiness, external_parasites, heat_stress. Omit to list all topics.","title":"Topic"}},"title":"flock_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/predator_proofing_guide":{"post":{"operationId":"predator_proofing_guide","summary":"Practical predator-proofing guidance: hardware cloth vs. chicken wire, dig-guard aprons, overhead","description":"Practical predator-proofing guidance: hardware cloth vs. chicken wire, dig-guard aprons, overhead\n    cover, secure locks, and common predators by risk. Use for \"how do I keep raccoons out of my coop\",\n    \"do I need a buried fence for foxes\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"predator_proofing_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/egg_production_info":{"post":{"operationId":"egg_production_info","summary":"Typical eggs-per-year ranges and egg color, for one breed or ranked across the whole reference. Use for","description":"Typical eggs-per-year ranges and egg color, for one breed or ranked across the whole reference. Use for\n    \"how many eggs per week does a Leghorn lay\", \"which breeds lay the most eggs\", \"what color eggs does an\n    Ameraucana lay\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"breed":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A chicken breed name; omit for a ranked overview across all breeds.","title":"Breed"}},"title":"egg_production_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/poultry_glossary":{"post":{"operationId":"poultry_glossary","summary":"Definitions of common backyard-poultry terms (broody, pullet, molt, vent, comb, pecking order, and","description":"Definitions of common backyard-poultry terms (broody, pullet, molt, vent, comb, pecking order, and\n    more). Use for \"what does broody mean\", \"what's a pullet\".","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":"poultry_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}}}}