{"openapi":"3.1.0","info":{"title":"Terrarium API","version":"0.1.0","description":"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 species.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://terrarium.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/terrarium/docs"},"termsOfService":"https://connectorbay.com/terrarium/terms"},"servers":[{"url":"https://terrarium.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/terrarium/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_care_info":{"post":{"operationId":"species_care_info","summary":"A species care profile: habitat summary, temperature/humidity needs, UVB needs, diet summary, lifespan,","description":"A species care profile: habitat summary, temperature/humidity needs, UVB needs, diet summary, lifespan,\n    and care-level rating. Use for \"how do I care for a leopard gecko\", \"what does a bearded dragon need\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A reptile or amphibian species name.","examples":["leopard gecko","bearded dragon","axolotl"],"title":"Name","type":"string"}},"required":["name"],"title":"species_care_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 20+ reptiles and amphibians in this guide by partial name, common alias, or scientific name.","description":"Search the 20+ reptiles and amphibians in this guide by partial name, common alias, or scientific name.\n    Use for \"do you have anything on tortoises\", \"what's a pacman frog\".","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/habitat_setup_guide":{"post":{"operationId":"habitat_setup_guide","summary":"A standalone, deeper habitat guide for a species: tank size by life stage (juvenile vs adult), substrate","description":"A standalone, deeper habitat guide for a species: tank size by life stage (juvenile vs adult), substrate\n    type, number and placement of hides, and decor. Use for \"what size tank for a bearded dragon\", \"what\n    substrate should I use for a ball python\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"species":{"description":"A reptile or amphibian species name.","examples":["bearded dragon","crested gecko","red-eared slider"],"title":"Species","type":"string"}},"required":["species"],"title":"habitat_setup_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/feeding_schedule_guide":{"post":{"operationId":"feeding_schedule_guide","summary":"Diet type, typical foods, supplementation, and feeding frequency by life stage (juvenile vs adult). Use","description":"Diet type, typical foods, supplementation, and feeding frequency by life stage (juvenile vs adult). Use\n    for \"how often should I feed my corn snake\", \"what do axolotls eat\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"species":{"description":"A reptile or amphibian species name.","examples":["corn snake","axolotl","veiled chameleon"],"title":"Species","type":"string"}},"required":["species"],"title":"feeding_schedule_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/shedding_guide":{"post":{"operationId":"shedding_guide","summary":"The normal shedding process for this species (reptile ecdysis, or an amphibian's different skin-shedding","description":"The normal shedding process for this species (reptile ecdysis, or an amphibian's different skin-shedding\n    pattern), signs of a healthy shed versus a stuck/retained shed, and what generally helps (humidity, soaking).\n    Use for \"is my gecko's shed stuck\", \"how often do snakes shed\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"species":{"description":"A reptile or amphibian species name.","examples":["leopard gecko","corn snake","white's tree frog"],"title":"Species","type":"string"}},"required":["species"],"title":"shedding_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/temperature_humidity_reference":{"post":{"operationId":"temperature_humidity_reference","summary":"Specific basking/gradient temperature and humidity target ranges for a species. Use for \"what temperature","description":"Specific basking/gradient temperature and humidity target ranges for a species. Use for \"what temperature\n    does a ball python need\", \"what humidity does a dart frog vivarium need\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"species":{"description":"A reptile or amphibian species name.","examples":["ball python","russian tortoise","poison dart frog"],"title":"Species","type":"string"}},"required":["species"],"title":"temperature_humidity_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/handling_guide":{"post":{"operationId":"handling_guide","summary":"General handling frequency and technique for a species, flagging ones that need gentler or less-frequent","description":"General handling frequency and technique for a species, flagging ones that need gentler or less-frequent\n    handling — a leopard gecko or crested gecko that can drop its tail, a skittish species like a green anole, a\n    stress-prone veiled chameleon, or a delicate-skinned amphibian like an axolotl or dart frog. Use for \"can I\n    handle my leopard gecko\", \"how often should I hold my bearded dragon\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"species":{"description":"A reptile or amphibian species name.","examples":["leopard gecko","green anole","axolotl"],"title":"Species","type":"string"}},"required":["species"],"title":"handling_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/common_health_signs_guide":{"post":{"operationId":"common_health_signs_guide","summary":"General signs of illness to watch for (lethargy, appetite loss, respiratory sounds/wheezing, stuck shed,","description":"General signs of illness to watch for (lethargy, appetite loss, respiratory sounds/wheezing, stuck shed,\n    unusual stool), plus species-specific watch items if a species is given. Explicitly not diagnostic — always\n    recommends a reptile-experienced veterinarian. Use for \"what are signs my reptile is sick\", \"warning signs\n    for a bearded dragon\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"species":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Optional: a species name for species-specific watch items in addition to the general list.","title":"Species"}},"title":"common_health_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/terrarium_glossary":{"post":{"operationId":"terrarium_glossary","summary":"Definitions of common terrarium-keeping terms (basking spot, UVB, thermal gradient, brumation, impaction,","description":"Definitions of common terrarium-keeping terms (basking spot, UVB, thermal gradient, brumation, impaction,\n    ectotherm, and more). Use for \"what does brumation mean\", \"what's a thermal gradient\".","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":"terrarium_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}}}}