GnistAI GnistAI
Log in

Animal Species

Animal species database — taxonomy, habitat, diet, lifespan, conservation status.

Overview   |   MCP Docs   |   API Docs   |   OpenAPI   |   Playground   |   Tutorial   |   Toolkits   |   Home
status: healthy status status healthy healthy tools: 8 tools tools 8 8 Science

Data source: Curated dataset (IUCN, Wikipedia)

MCP MCP Protocol

Endpoint https://context.gnist.ai/mcp/animals/
claude_desktop_config.json
{
  "mcpServers": {
    "gnist-animals": {
      "url": "https://context.gnist.ai/mcp/animals/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}
Shell
curl -X POST "https://context.gnist.ai/mcp/animals/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_animal", "arguments": {"animal_id": "example"}}}'

API REST API

API Root https://context.gnist.ai/rest/animals/

8 endpoints available:

Shell
curl "https://context.gnist.ai/rest/animals/get_animal?animal_id=example" \
  -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx

resp = httpx.get(
    "https://context.gnist.ai/rest/animals/get_animal",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    params={
        "animal_id": "example"
},
)
print(resp.json())

OpenAPI Spec  ·  Full API Docs

CLI Command Line

Command gc animals

CLI documentation will be available when the GnistAI SDK is published.

Install
pip install gnistai

Available Tools (8)

get_animal
Get detailed information about an animal species.
ParameterTypeRequiredDescription
animal_idstringrequiredAnimal ID slug (e.g. african-elephant, blue-whale, axolotl).
search_animals
Search the animal species database.
ParameterTypeRequiredDescription
querystringrequiredSearch by common name, scientific name, or family.
limitintegeroptional (default: 20)
list_animals_by_class
List animals by taxonomic class.
ParameterTypeRequiredDescription
animal_classstringrequiredTaxonomic class (e.g. Mammalia, Aves, Reptilia, Amphibia).
limitintegeroptional (default: 50)
list_animals_by_habitat
List animals by habitat type.
ParameterTypeRequiredDescription
habitatstringrequiredHabitat type (e.g. Forest, Ocean, Savanna, Arctic).
limitintegeroptional (default: 50)
list_endangered_species
List endangered and critically endangered animal species.
ParameterTypeRequiredDescription
limitintegeroptional (default: 20)
get_animal_classes
List all taxonomic classes in the database.
get_animal_habitats
List all habitat types in the database.
report_feedback
Report a bug, feature request, or general feedback for this data source.
ParameterTypeRequiredDescription
feedbackstringrequired
feedback_typestringoptional (default: "general")

Related