{"openapi":"3.0.3","info":{"title":"Gnist Context — Animal Species","description":"Animal species database — taxonomy, habitat, diet, lifespan, conservation status.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/animals/`\n- **Toolkit page:** `/toolkits/animals`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/animals/get_animal":{"post":{"tags":["Science"],"summary":"get_animal","description":"Get detailed information about an animal species.\n\nReturns taxonomy, habitat, diet, lifespan, physical characteristics, conservation status, and description.","operationId":"animals_get_animal","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"animal_id":{"description":"Animal ID slug (e.g. african-elephant, blue-whale, axolotl).","type":"string"}},"required":["animal_id"],"type":"object"}}}}}},"/rest/animals/search_animals":{"post":{"tags":["Science"],"summary":"search_animals","description":"Search the animal species database.","operationId":"animals_search_animals","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"query":{"description":"Search by common name, scientific name, or family.","type":"string"},"limit":{"default":20,"type":"integer"}},"required":["query"],"type":"object"}}}}}},"/rest/animals/list_animals_by_class":{"post":{"tags":["Science"],"summary":"list_animals_by_class","description":"List animals by taxonomic class.","operationId":"animals_list_animals_by_class","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"animal_class":{"description":"Taxonomic class (e.g. Mammalia, Aves, Reptilia, Amphibia).","type":"string"},"limit":{"default":50,"type":"integer"}},"required":["animal_class"],"type":"object"}}}}}},"/rest/animals/list_animals_by_habitat":{"post":{"tags":["Science"],"summary":"list_animals_by_habitat","description":"List animals by habitat type.","operationId":"animals_list_animals_by_habitat","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"habitat":{"description":"Habitat type (e.g. Forest, Ocean, Savanna, Arctic).","type":"string"},"limit":{"default":50,"type":"integer"}},"required":["habitat"],"type":"object"}}}}}},"/rest/animals/list_endangered_species":{"post":{"tags":["Science"],"summary":"list_endangered_species","description":"List endangered and critically endangered animal species.","operationId":"animals_list_endangered_species","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"limit":{"default":20,"type":"integer"}},"type":"object"}}}}}},"/rest/animals/get_animal_classes":{"post":{"tags":["Science"],"summary":"get_animal_classes","description":"List all taxonomic classes in the database.","operationId":"animals_get_animal_classes","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}]}},"/rest/animals/get_animal_habitats":{"post":{"tags":["Science"],"summary":"get_animal_habitats","description":"List all habitat types in the database.","operationId":"animals_get_animal_habitats","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}]}},"/rest/animals/report_feedback":{"post":{"tags":["Science"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"animals_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Science","description":"Data sources: Science"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}