Terrarium

Terrarium — connector documentation

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

What Terrarium is for

The question every reptile or amphibian owner eventually has — what size tank does this actually need, why won't the shed come off its toes, is it normal that it hasn't eaten in three weeks, is this frog actually dangerous to touch — answered from one hand-curated pet-care reference, without hunting through a dozen contradictory care-sheet forums.

What it does

A full care profile — habitat summary, temperature/humidity needs, UVB needs, diet summary, lifespan, and a care-level rating — for 20+ common pet reptiles and amphibians: leopard gecko, bearded dragon, corn snake, ball python, crested gecko, red-eared slider, Russian tortoise, green anole, blue-tongue skink, African fat-tailed gecko, king snake, milk snake, veiled chameleon, poison dart frog, White's tree frog, fire-bellied toad, axolotl, gargoyle gecko, tiger salamander, eastern box turtle, Pacman frog, and rosy boa (species_care_info); a search across names, aliases and scientific names (species_search); a standalone, deeper habitat guide covering tank size by life stage, substrate, hides and decor (habitat_setup_guide); a feeding-schedule guide covering diet type, foods, supplementation and feeding frequency by juvenile vs adult life stage (feeding_schedule_guide); a shedding guide covering the normal reptile shedding process (and the different, more frequent amphibian skin-shedding pattern), the signs of a healthy shed versus a stuck/retained shed — most often on the toes or tail tip — and what generally helps, such as humidity and soaking (shedding_guide); specific basking/gradient temperature and humidity target ranges (temperature_humidity_reference); handling frequency and technique guidance that flags species needing gentler or less-frequent handling, such as tail-dropping geckos, skittish species, stress-prone chameleons, or delicate-skinned amphibians (handling_guide); general illness warning signs — lethargy, appetite loss, respiratory sounds, stuck shed, unusual stool — with species-specific watch items layered on top, always explicitly not diagnostic (common_health_signs_guide); and a glossary of common terrarium-keeping terms like basking spot, UVB, thermal gradient, brumation, impaction and ectotherm (terrarium_glossary).

What it is not

Not a substitute for a reptile-experienced veterinarian. Health-sign guidance is deliberately general and non-diagnostic — it always points toward a vet visit rather than attempting to name a condition. One fact worth calling out because it's so often misunderstood: wild poison dart frogs get their toxicity from alkaloid compounds sequestered from a specific wild diet of certain ants, mites and other arthropods. Captive-bred dart frogs — the norm in the pet trade, and the only kind this guide assumes — are raised on fruit flies and springtails and are not toxic to handle; gentle, minimal handling is still recommended for their sake, since their skin is delicate and they stress easily, not because they're dangerous. Terrarium covers reptiles and amphibians specifically — for dogs and cats, fish and aquariums, or houseplants, the sibling Paws, Reef and Frond connectors cover that ground.

Tools

Species

species_care_info — A species care profile: habitat summary, temperature/humidity needs, UVB needs, diet summary, lifespan, and care-level rating. Use for "how do I care for a leopard gecko", "what does a bearded dragon need". Args: name.

species_search — Search the 20+ reptiles and amphibians in this guide by partial name, common alias, or scientific name. Use for "do you have anything on tortoises", "what's a pacman frog". Args: query.

Setup & Care

habitat_setup_guide — A standalone, deeper habitat guide for a species: tank size by life stage (juvenile vs adult), substrate type, number and placement of hides, and decor. Use for "what size tank for a bearded dragon", "what substrate should I use for a ball python". Args: species.

feeding_schedule_guide — Diet type, typical foods, supplementation, and feeding frequency by life stage (juvenile vs adult). Use for "how often should I feed my corn snake", "what do axolotls eat". Args: species.

temperature_humidity_reference — Specific basking/gradient temperature and humidity target ranges for a species. Use for "what temperature does a ball python need", "what humidity does a dart frog vivarium need". Args: species.

Handling & Health

shedding_guide — The normal shedding process for this species (reptile ecdysis, or an amphibian's different skin-shedding pattern), signs of a healthy shed versus a stuck/retained shed, and what generally helps (humidity, soaking). Use for "is my gecko's shed stuck", "how often do snakes shed". Args: species.

handling_guide — General handling frequency and technique for a species, flagging ones that need gentler or less-frequent handling — a leopard gecko or crested gecko that can drop its tail, a skittish species like a green anole, a stress-prone veiled chameleon, or a delicate-skinned amphibian like an axolotl or dart frog. Use for "can I handle my leopard gecko", "how often should I hold my bearded dragon". Args: species.

common_health_signs_guide — General signs of illness to watch for (lethargy, appetite loss, respiratory sounds/wheezing, stuck shed, unusual stool), plus species-specific watch items if a species is given. Explicitly not diagnostic — always recommends a reptile-experienced veterinarian. Use for "what are signs my reptile is sick", "warning signs for a bearded dragon". Args: species.

Reference

terrarium_glossary — Definitions of common terrarium-keeping terms (basking spot, UVB, thermal gradient, brumation, impaction, ectotherm, and more). Use for "what does brumation mean", "what's a thermal gradient". 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/terrarium/support

Terrarium — Privacy Policy

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

What Terrarium is. Terrarium is a connector (an MCP server and REST API) that AI assistants and personal agents call on your behalf for a reptile and amphibian pet-care reference: species care profiles, habitat setup, feeding schedules, shedding guidance, temperature/humidity targets, handling guidance, general illness warning signs, 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, alias, or search term, or a glossary term — 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 animal 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. Terrarium is a general-audience service operated by the adult using the assistant.

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

Terrarium — Terms of Service

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

1. The Service. Terrarium returns a hand-curated reptile and amphibian pet-care reference — species care profiles, habitat setup, feeding schedules, shedding guidance, temperature/humidity targets, handling guidance, general illness warning signs, and a glossary — for 20+ common pet reptiles and amphibians, from data bundled with the server. It is accessed through an AI assistant or directly over MCP or HTTP.
2. General information, not veterinary advice. Terrarium provides general pet-care information for reference only. It is not veterinary advice, and in particular its illness-warning-sign guidance is explicitly not diagnostic: it is a general list of things to watch for, not an assessment of any specific animal's condition. If your animal shows signs of illness or injury, or you have any health concern, contact a reptile-experienced veterinarian rather than relying on the Service.
3. Individual results vary. Real animals, enclosures and households vary — a care-level rating, a feeding frequency, or a temperature range is general guidance, not a guarantee of a particular outcome for your specific animal.
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 an animal — 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/terrarium

Terrarium support

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

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