{"openapi":"3.1.0","info":{"title":"Aviary API","version":"0.1.0","description":"A hand-curated companion-bird species care reference: diet, cage size, social/enrichment needs, typical lifespan, health warning signs, noise/talking-ability expectations, and CITES/trade-restriction notes — all local, for 24 common pet bird species.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://aviary.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/aviary/docs"},"termsOfService":"https://connectorbay.com/aviary/terms"},"servers":[{"url":"https://aviary.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/aviary/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/species_info":{"post":{"operationId":"species_info","summary":"One companion bird species' care needs, temperament, typical lifespan, noise level, and talking","description":"One companion bird species' care needs, temperament, typical lifespan, noise level, and talking\n    ability. Use for \"how do I care for a cockatiel\", \"is an African grey a good talker\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A companion bird species name.","examples":["budgerigar","african grey","blue-and-gold macaw"],"title":"Name","type":"string"}},"required":["name"],"title":"species_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/species_search":{"post":{"operationId":"species_search","summary":"Search the 24 companion bird species in this guide by partial name, common alias, or scientific","description":"Search the 24 companion bird species in this guide by partial name, common alias, or scientific\n    name. Use for \"do you have anything on caiques\", \"what's a pionus\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"default":"","description":"Partial species name, alias, or scientific name; empty lists all species.","title":"Query","type":"string"}},"title":"species_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/species_by_experience_level":{"post":{"operationId":"species_by_experience_level","summary":"Companion bird species suited to a given keeper experience level — beginner-friendly through","description":"Companion bird species suited to a given keeper experience level — beginner-friendly through\n    experienced-only. Use for \"what's a good first pet bird\", \"which birds are only for experienced\n    owners\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"level":{"description":"beginner | intermediate | experienced","title":"Level","type":"string"}},"required":["level"],"title":"species_by_experience_levelArguments","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/cage_size_guide":{"post":{"operationId":"cage_size_guide","summary":"General cage-size guidance — minimum dimensions and bar spacing by size category, or specifics for","description":"General cage-size guidance — minimum dimensions and bar spacing by size category, or specifics for\n    a named species. Use for \"how big a cage does a cockatiel need\", \"what bar spacing is safe for a\n    macaw\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"species":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A species name; omit for the general size-category guide.","title":"Species"}},"title":"cage_size_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/diet_guide":{"post":{"operationId":"diet_guide","summary":"General dietary needs — pellet/seed/fresh-food balance, foods to avoid, and species exceptions","description":"General dietary needs — pellet/seed/fresh-food balance, foods to avoid, and species exceptions\n    (lories, eclectus, hyacinth macaw) — or specifics for a named species. Use for \"what should I feed a\n    budgie\", \"can birds eat avocado\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"species":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A species name; omit for the general diet guide.","title":"Species"}},"title":"diet_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/health_warning_signs_guide":{"post":{"operationId":"health_warning_signs_guide","summary":"General, non-diagnostic warning signs that a companion bird may be unwell (fluffed feathers, tail","description":"General, non-diagnostic warning signs that a companion bird may be unwell (fluffed feathers, tail\n    bobbing, appetite change, and more), with a strong reminder to contact an avian veterinarian promptly\n    since birds instinctively hide illness. Use for \"what are signs a bird is sick\", \"how do I know if my\n    parrot is unwell\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"health_warning_signs_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/lifespan_reference":{"post":{"operationId":"lifespan_reference","summary":"Typical lifespan ranges by species, framed as a serious long-term-commitment consideration for","description":"Typical lifespan ranges by species, framed as a serious long-term-commitment consideration for\n    long-lived species. Use for \"how long do African greys live\", \"how long-lived is a budgie compared to\n    a macaw\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"species":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A species name; omit to list all species.","title":"Species"}},"title":"lifespan_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/legal_and_conservation_notes":{"post":{"operationId":"legal_and_conservation_notes","summary":"CITES/trade-restriction status where applicable, as a general, non-binding note — not legal advice.","description":"CITES/trade-restriction status where applicable, as a general, non-binding note — not legal advice.\n    Always recommends checking current national and local regulations before acquiring a species. Use for\n    \"is it legal to own a hyacinth macaw\", \"what's CITES Appendix I mean for parrots\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"species":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A species name; omit for the general CITES/trade overview.","title":"Species"}},"title":"legal_and_conservation_notesArguments","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/bird_glossary":{"post":{"operationId":"bird_glossary","summary":"Definitions of common companion-bird terms (molt, preening, flock/social bird, zygodactyl feet, and","description":"Definitions of common companion-bird terms (molt, preening, flock/social bird, zygodactyl feet, and\n    more). Use for \"what does preening mean\", \"what's a scream phase\".","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":"bird_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}}}}