Aviary

Aviary — connector documentation

• MCP endpoint: https://aviary.connectorbay.com/mcp
• REST API: POST https://aviary.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://aviary.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://aviary.connectorbay.com/health · Tool schemas: https://aviary.connectorbay.com/tools.json
• Publisher: Unify Dynamics LLC · connectorbay.com/aviary · agent@connectorbay.com

What Aviary is for

The question every prospective or current pet-bird owner eventually has — is this species too loud for an apartment, how big a cage does it actually need, is 15 years or 50 years the realistic commitment, and is it even legal to bring home — answered from one hand-curated companion-bird species reference, without hunting through a dozen contradictory forum threads.

What it does

Care needs, temperament, typical lifespan, noise level and talking ability for 24 common companion bird species — budgerigar, cockatiel, African grey (Congo and Timneh), five macaw varieties (blue-and-gold, scarlet, hyacinth, green-winged), two cockatoos (sulphur-crested, umbrella), two conures (sun, green-cheeked), peach-faced lovebird, canary, zebra finch, two Amazon parrots (blue-fronted, yellow-naped), eclectus, quaker (monk) parakeet, Indian ringneck parakeet, rainbow lorikeet, pionus, black-headed caique, and Senegal parrot (species_info); a search across names, aliases and scientific names (species_search); a filter by keeper experience level — beginner, intermediate, or experienced-only (species_by_experience_level); general cage-size guidance by size category or a named species (cage_size_guide); general dietary guidance — the pellet/fresh-food/seed balance, foods to avoid, and real species exceptions like the nectar-feeding lories or the high-fat needs of hyacinth macaws (diet_guide); general, non-diagnostic health warning signs with a strong reminder to contact an avian veterinarian promptly, since birds instinctively conceal illness (health_warning_signs_guide); typical lifespan ranges verified against public reporting, framed as a serious long-term-commitment consideration since companion bird lifespans vary from roughly 5 years to 65+ years by species (lifespan_reference); CITES and trade-restriction notes where they apply, as a general, non-binding pointer to check current regulations rather than a legal ruling (legal_and_conservation_notes); and a glossary of common bird-keeping terms like molt, preening and zygodactyl feet (bird_glossary).

What it is not

Not a substitute for an avian veterinarian or a wildlife-law authority. Health warning signs are deliberately general and non-diagnostic — birds are prey animals that hide illness well, so any of these signs is worth a prompt call to a vet who specializes in birds specifically, not a self-diagnosis from this reference. Legal and conservation notes describe CITES appendix status and known domestic restrictions (like invasive-species bans on Quaker parakeets in some U.S. states) as general background only — they are never a definitive ruling on whether owning a particular bird is lawful in your location, which depends on current national and local rules this reference cannot track in real time. Aviary covers companion bird species specifically — for general pet care across other animals, a sibling connector may cover that ground.

Tools

Species

species_info — One companion bird species' care needs, temperament, typical lifespan, noise level, and talking ability. Use for "how do I care for a cockatiel", "is an African grey a good talker". Args: name.

species_search — Search the 24 companion bird species in this guide by partial name, common alias, or scientific name. Use for "do you have anything on caiques", "what's a pionus". Args: query.

species_by_experience_level — Companion bird species suited to a given keeper experience level — beginner-friendly through experienced-only. Use for "what's a good first pet bird", "which birds are only for experienced owners". Args: level.

Husbandry

cage_size_guide — General cage-size guidance — minimum dimensions and bar spacing by size category, or specifics for a named species. Use for "how big a cage does a cockatiel need", "what bar spacing is safe for a macaw". Args: species.

diet_guide — General dietary needs — pellet/seed/fresh-food balance, foods to avoid, and species exceptions (lories, eclectus, hyacinth macaw) — or specifics for a named species. Use for "what should I feed a budgie", "can birds eat avocado". Args: species.

Health

health_warning_signs_guide — General, non-diagnostic warning signs that a companion bird may be unwell (fluffed feathers, tail bobbing, appetite change, and more), with a strong reminder to contact an avian veterinarian promptly since birds instinctively hide illness. Use for "what are signs a bird is sick", "how do I know if my parrot is unwell".

Reference

lifespan_reference — Typical lifespan ranges by species, framed as a serious long-term-commitment consideration for long-lived species. Use for "how long do African greys live", "how long-lived is a budgie compared to a macaw". Args: species.

legal_and_conservation_notes — CITES/trade-restriction status where applicable, as a general, non-binding note — not legal advice. Always recommends checking current national and local regulations before acquiring a species. Use for "is it legal to own a hyacinth macaw", "what's CITES Appendix I mean for parrots". Args: species.

bird_glossary — Definitions of common companion-bird terms (molt, preening, flock/social bird, zygodactyl feet, and more). Use for "what does preening mean", "what's a scream phase". 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/aviary/support

Aviary — Privacy Policy

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

What Aviary is. Aviary is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf for a companion-bird species care reference: species care needs, cage-size and diet guidance, health warning signs, lifespan figures, CITES/trade-restriction notes, and a glossary. You interact with your assistant; the assistant sends us only the arguments needed for that one lookup.

What we receive. The arguments of each tool call — a species name, an experience-level filter, or no argument at all — 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 a bundled, hand-curated reference file 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, your name, or any information about a specific pet bird or its health, 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 answered 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. Aviary is a general-audience service operated by the adult using the assistant.

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

Aviary — Terms of Service

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

1. The Service. Aviary returns a hand-curated companion-bird species care reference — care needs, cage-size and diet guidance, health warning signs, lifespan figures, CITES/trade-restriction notes, and a glossary — for 24 common pet bird species, from data bundled with the server. It is accessed through an AI assistant or directly over MCP or HTTP.
2. General information, not professional advice. Aviary provides general species-care information for reference only. It is not veterinary advice: health warning signs are deliberately general and non-diagnostic, not a diagnosis for any specific bird. If you observe signs a bird may be unwell, contact an avian veterinarian promptly rather than relying on the Service. It is also not legal advice: CITES and trade-restriction notes are general background, never a definitive ruling on whether owning, importing, or breeding a particular bird is lawful in your jurisdiction — always verify current rules with your national CITES management authority and local wildlife regulations.
3. Individual results vary. Real birds, households, and jurisdictions vary — a lifespan figure, a cage-size recommendation, or a legal note is a general starting point, not a guarantee or a ruling for your specific situation.
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 a bundled reference file, 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 — including harm to a bird or a legal or regulatory consequence — arising from use of or reliance on the Service. 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/aviary

Aviary support

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

• MCP endpoint: https://aviary.connectorbay.com/mcp
• REST API: https://aviary.connectorbay.com/openapi.json
• Live status: https://aviary.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. Aviary never asks for them.