# Zoos & Aquariums

> Explore zoos and aquariums worldwide — filter by the animals they host, size, visitors and accreditation. Sourced and kept in sync from Wikipedia.

This site is agent-friendly: the full dataset is queryable by any attribute via a public JSON API (no API key) and an MCP server. Data is sourced from Wikipedia (CC BY-SA).

## Data
- 897 zoos & aquariums across 97 countries.

## API (no key, rate-limited per IP)
- Search zoos & aquariums by any attribute: `GET http://zoos.tello.app/api/v1/locations?<filters>`
- A single zoo: `GET http://zoos.tello.app/api/v1/locations/{slug}`
- Countries with counts: `GET http://zoos.tello.app/api/v1/countries`
- Machine-readable filter schema (every queryable attribute): `GET http://zoos.tello.app/api/v1/schema`
- OpenAPI 3 spec: `GET http://zoos.tello.app/openapi.json`

## MCP server
- Endpoint: `http://zoos.tello.app/mcp` (Streamable HTTP).
- Tools: `search`, `get`, `list_countries`, `describe_filters`.

## Queryable attributes
- `search` — Name search
- `country` — Country
- `animals` — Animals (one of: Giant panda, Red panda, Polar bear, Sea lion, Sea otter, Sea turtle, Killer whale, Komodo dragon, Beluga, Tasmanian devil, Snow leopard, Elephant, Lion, Tiger, Leopard, Jaguar, Cheetah, Gorilla, Chimpanzee, Orangutan, Gibbon, Lemur, Monkey, Giraffe, Rhinoceros, Hippopotamus, Zebra, Bison, Camel, Kangaroo, Koala, Wombat, Sloth, Capybara, Meerkat, Otter, Bear, Wolf, Fox, Bat, Penguin, Flamingo, Eagle, Owl, Parrot, Peacock, Ostrich, Toucan, Crocodile, Alligator, Snake, Tortoise, Iguana, Chameleon, Frog, Axolotl, Shark, Dolphin, Whale, Seal, Walrus, Manatee, Octopus, Jellyfish, Stingray, Seahorse, Turtle, Crab, Pufferfish)
- `num_species` — Number of species (range: `num_species_min`, `num_species_max`)
- `annual_visitors` — Annual visitors (range: `annual_visitors_min`, `annual_visitors_max`)
- `area_ha` — Area (range: `area_ha_min`, `area_ha_max` ha)
- `opened` — Opened (year) (range: `opened_min`, `opened_max`)
- `accreditation` — Accreditation
- `has_image` — Has photo (1 / true)
- `has_coordinates` — Has coordinates (1 / true)
- `sort` — one of: species_desc, visitors_desc, largest, name, newest

## Examples
- Find zoos & aquariums in Norway → `GET http://zoos.tello.app/api/v1/locations?country=norway`
- zoos & aquariums of type "Giant panda" → `GET http://zoos.tello.app/api/v1/locations?animals=Giant+panda`
- zoos & aquariums with Number of species over 100 → `GET http://zoos.tello.app/api/v1/locations?num_species_min=100`

## Per-entry Markdown
Append `.md` to any zoo URL (e.g. `http://zoos.tello.app/location/<slug>.md`), or send `Accept: text/markdown`, to get clean Markdown instead of HTML.