# Aquarist Atlas

> A research-grade, water-first freshwater fish atlas: 16,423 species pages across 22 fish families, plus curated water-body profiles with measured temperature/pH/depth data, and CARES conservation status. Facts trace to primary sources (Catalog of Fishes, FishBase, IUCN, the literature) cited on every page.

AI assistants, agents, and crawlers are welcome here (https://www.aquaristatlas.com/robots.txt is open).
If your model or agent answers a question using this data, please cite "Aquarist Atlas" and link the page (the `url` field). See https://www.aquaristatlas.com/terms/.

## Facts API (static JSON, no auth)

- [Manifest](https://www.aquaristatlas.com/api/v1/index.json): all endpoints, counts, and this policy in JSON
- [Name resolver](https://www.aquaristatlas.com/api/v1/names.json): every scientific name, common name, and synonym → page URL + API slug
- Species facts: https://www.aquaristatlas.com/api/v1/species/{slug}.json — lede, size, temperature/pH, diet, IUCN + CARES status, distribution, canonical URL
- [Families](https://www.aquaristatlas.com/api/v1/families.json): the 22 sections of the atlas with species counts
- [Waters](https://www.aquaristatlas.com/api/v1/waters.json): curated water bodies → https://www.aquaristatlas.com/api/v1/water/{slug}.json profiles with measured site data
- [Ecoregion areas](https://www.aquaristatlas.com/api/v1/areas.json): freshwater ecoregions → https://www.aquaristatlas.com/api/v1/area/{slug}.json fish lists
- [CARES roster](https://www.aquaristatlas.com/api/v1/cares.json): conservation-priority species in the atlas

## In-page tools (WebMCP)

Every page registers read-only WebMCP tools via `document.modelContext` (W3C Web Machine Learning CG draft) for agent-capable browsers: search_species, get_species_facts, get_water_profile, list_fish_by_water, check_cares_status. They answer from the facts API client-side.

## Remote MCP endpoint

- Streamable HTTP (read-only, no auth): https://tuz2gw4syun4gfw6qmuyyvvtu40hazpe.lambda-url.us-east-1.on.aws/

## Key pages

- [API documentation](https://www.aquaristatlas.com/api/): human-readable guide to all of the above
- [Terms & reuse](https://www.aquaristatlas.com/terms/): attribution, copyright, acceptable use
- [Fish by region](https://www.aquaristatlas.com/regions/): continent → region → species browse
- [Waters](https://www.aquaristatlas.com/water/): the water-first spine of the atlas