# Waterfalls

> Explore thousands of waterfalls worldwide. Filter by height, type and country. 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
- 554 waterfalls across 69 countries.

## Pages
- [Home](https://waterfalls.tello.app/): browse and filter every waterfalls.
- [Waterfalls by country](https://waterfalls.tello.app/countries)
- [About](https://waterfalls.tello.app/about)

## Top countries
- [Waterfalls in United States](https://waterfalls.tello.app/country/united-states): 102
- [Waterfalls in Australia](https://waterfalls.tello.app/country/australia): 67
- [Waterfalls in Canada](https://waterfalls.tello.app/country/canada): 30
- [Waterfalls in United Kingdom](https://waterfalls.tello.app/country/united-kingdom): 27
- [Waterfalls in India](https://waterfalls.tello.app/country/india): 19
- [Waterfalls in Norway](https://waterfalls.tello.app/country/norway): 18
- [Waterfalls in Nepal](https://waterfalls.tello.app/country/nepal): 13
- [Waterfalls in New Zealand](https://waterfalls.tello.app/country/new-zealand): 12
- [Waterfalls in Poland](https://waterfalls.tello.app/country/poland): 9
- [Waterfalls in Taiwan](https://waterfalls.tello.app/country/taiwan): 9

## Notable waterfalls
- [Tugela Falls](https://waterfalls.tello.app/location/tugela-falls-2029), South Africa
- [Balta of Striga](https://waterfalls.tello.app/location/balta-of-striga-2327), Greece
- [Tres Hermanas Falls](https://waterfalls.tello.app/location/tres-hermanas-falls-2030), Peru
- [Oloupena Falls](https://waterfalls.tello.app/location/oloupena-falls-2031), United States
- [Yumbilla Falls](https://waterfalls.tello.app/location/yumbilla-falls-2033), Peru
- [VinnufossenVinnufallet](https://waterfalls.tello.app/location/vinnufossenvinnufallet-2035), Norway
- [James Bruce Falls](https://waterfalls.tello.app/location/james-bruce-falls-2037), Canada
- [Browne Falls](https://waterfalls.tello.app/location/browne-falls-2039), New Zealand
- [Ramnefjellsfossen](https://waterfalls.tello.app/location/ramnefjellsfossen-2040), Norway
- [Mongefossen](https://waterfalls.tello.app/location/mongefossen-2044), Norway
- [Mutarazi Falls](https://waterfalls.tello.app/location/mutarazi-falls-2046), Zimbabwe
- [Yosemite Falls](https://waterfalls.tello.app/location/yosemite-falls-2049)
- [Kjeragfossen](https://waterfalls.tello.app/location/kjeragfossen-2053), Norway
- [Kjelfossen](https://waterfalls.tello.app/location/kjelfossen-2048), Norway
- [Sulphide Creek Falls](https://waterfalls.tello.app/location/sulphide-creek-falls-2734), United States
- [Lady Alice Falls](https://waterfalls.tello.app/location/lady-alice-falls-2853), New Zealand
- [Pilj Waterfall](https://waterfalls.tello.app/location/pilj-waterfall-2409), Serbia
- [Tyssestrengene](https://waterfalls.tello.app/location/tyssestrengene-2380), Norway
- [Mardalsfossen](https://waterfalls.tello.app/location/mardalsfossen-2374), Norway
- [LangfossenLangfoss](https://waterfalls.tello.app/location/langfossenlangfoss-2062), Norway

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

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

## Queryable attributes
- `search`: Name search
- `country`: Country
- `height_m`: Height (range: `height_m_min`, `height_m_max` m)
- `type`: Type (one of: Plunge, Cascade, Tiered, Block, Horsetail, Fan, Cataract, Chute, Punchbowl, Segmented)
- `num_drops`: Number of drops (range: `num_drops_min`, `num_drops_max`)
- `watercourse`: River / watercourse
- `has_image`: Has photo (1 / true)
- `has_coordinates`: Has coordinates (1 / true)
- `sort`: one of: height_desc, name, newest

## Examples
- Find waterfalls in Norway → `GET https://waterfalls.tello.app/api/v1/locations?country=norway`
- waterfalls of type "Plunge" → `GET https://waterfalls.tello.app/api/v1/locations?type=Plunge`
- waterfalls with Height over 100 m → `GET https://waterfalls.tello.app/api/v1/locations?height_m_min=100`

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