Science
Data source: Curated dataset (IUCN, Wikipedia)
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"}}}'
REST API
API Root
https://context.gnist.ai/rest/animals/
8 endpoints available:
GET /rest/animals/get_animalGET /rest/animals/search_animalsGET /rest/animals/list_animals_by_classGET /rest/animals/list_animals_by_habitatGET /rest/animals/list_endangered_speciesGET /rest/animals/get_animal_classesGET /rest/animals/get_animal_habitatsGET /rest/animals/report_feedback
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())
Command Line
Command
gc animals
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (8)
get_animalGet detailed information about an animal species.
| Parameter | Type | Required | Description |
|---|---|---|---|
animal_id | string | required | Animal ID slug (e.g. african-elephant, blue-whale, axolotl). |
search_animalsSearch the animal species database.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Search by common name, scientific name, or family. |
limit | integer | optional | (default: 20) |
list_animals_by_classList animals by taxonomic class.
| Parameter | Type | Required | Description |
|---|---|---|---|
animal_class | string | required | Taxonomic class (e.g. Mammalia, Aves, Reptilia, Amphibia). |
limit | integer | optional | (default: 50) |
list_animals_by_habitatList animals by habitat type.
| Parameter | Type | Required | Description |
|---|---|---|---|
habitat | string | required | Habitat type (e.g. Forest, Ocean, Savanna, Arctic). |
limit | integer | optional | (default: 50) |
list_endangered_speciesList endangered and critically endangered animal species.
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | integer | optional | (default: 20) |
get_animal_classesList all taxonomic classes in the database.
get_animal_habitatsList all habitat types in the database.
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |