Data · La Saladita, Guerrero (17.8375°N, 101.7606°W)

The La Saladita Data API

Everything the field guide shows is available as JSON. It is free to use with attribution, updated on the same schedule as the pages, and served from the same origin. No key, no sign-up.

Surf, weather and sea

EndpointWhat it returnsRefresh
/api/forecastTen-day surf forecast for the point: hourly swell trains, wind, tide phase and a 1-to-10 quality score per hour; a daily headline score, size, best window, board call and a plain-English report; active tropical cyclones with distance and bearing; ENSO state; nearby-spot notes. Field today.peak_quality is the headline number.Hourly; browsers revalidate every 2 min
/api/weatherWeather forecast for the beach: temperature, rain, CAPE, pressure, wind, with the last days of the local station alongside the model. daily[].rain_chance_v2 is the chance of 1 mm or more at the beach, calibrated on the station. historical_context compares this year with 2021–2025 in model values (rain: ECMWF IFS archive, labeled rain_source: "model"; swell: marine model); historical_context.beach_gauge_rain_to_date is what the gauge in La Saladita measured this year and this month.Hourly
/api/stationThe live Ambient Weather station at Saladita: latest reading, 24-hour extremes, and a de-tided pressure trend (the barometer here has a twice-daily tide of 2 to 2.5 mb peak-to-trough, removed with a monthly table fitted to the station).Every 5 min
/api/astronomySunrise, sunset, moon phase and tide predictions from a harmonic fit to the Zihuatanejo gauge.Daily
/api/sstSea surface temperature at the nearest 0.25° grid node, with climatology and anomaly.Daily
/api/ocean-colorChlorophyll-a from the S-NPP VIIRS grid cell 7.6 km west-southwest of the point, against a 2012–2025 baseline from the same sensor and the same cell. The reading carries its date; when no recent reading exists the payload says unavailable.Daily
/api/seasonalEastern Pacific hurricane season to date and climatology: rain, temperature and wind from ERA5 1979–2025; swell from the MFWAM wave model, October 2021 to December 2025.Weekly
/api/earthquakesMagnitude 3+ earthquakes within 300 km over the last 30 days, compared with 2015–2025 at the same radius and magnitude floor (about 2.5 per 30 days; 0 to 5 in eight windows out of ten).Hourly
/api/bathymetryDepth profile offshore of the point.Static

Wildlife

EndpointWhat it returns
/api/species?sp=Crocodylus%20acutusOne species: summary, taxonomy, IUCN status, local research-grade observation history within 25 km, photos with credits, similar species. Also accepts slug=. Static pages exist for every species at /species/<slug>/; the A–Z list is at /species/all/.
/api/birds, /api/mammals, /api/herps, /api/insects, /api/fish, /api/plants, /api/mushroomsRecent iNaturalist observations for each group within the study radius (last 30 days). /api/birds reads GBIF records inside the box 17.61–18.07°N, 101.51–102.01°W, about 25 km to each side of the village and up to 37 km at the corners; the payload states the box in search_area.
/api/bird-climatologyTwenty-five years of monthly bird occurrence for the site.
/api/bird-sounds?species=…Recordings for a bird species, quality-ranked.
/api/ebird?hotspot=…Nearest active eBird hotspots and recent checklists.
/api/turtles, /api/turtle-telemetry?species=…Sea-turtle records and satellite-track summaries for the coast.
/api/whalesHumpback and other cetacean records for the bay.
/api/lagoonSpecies and seasonality of the lagoon behind the village.
/api/field-log?class=…&type=…The public field log: dated, geolocated sightings from the beach.
/api/iucn-enrichmentIUCN status for every species in the local index.

Findings

Each finding on /findings/ has a data endpoint: /api/findings-hurricane-tracks, /api/findings-hurricane-phenology, /api/findings-wave-power, /api/findings-marine-heatwaves, /api/findings-climate-trends, /api/findings-rainfall-regime, /api/findings-citizen-science-growth.

Example

curl -s https://lasaladita.com/api/forecast | jq '.today | {date, peak_quality, quality_label, peak_size, peak_face_range, best_window, board_rec}'

Use this data with AI (MCP)

The same data is available as a public, read-only Model Context Protocol server at https://lasaladita.com/mcp (Streamable HTTP, no key, no sign-up). An assistant connected to it can ask for the surf forecast, tides, weather, tropical storms, nearby spots, species, findings and the art collection, and each answer carries its source URL and the caveats the pages show.

ClientHow to connect
Claude (claude.ai, desktop)Settings → Connectors → Add custom connector, URL https://lasaladita.com/mcp.
Claude Codeclaude mcp add --transport http lasaladita https://lasaladita.com/mcp
ChatGPT and other clientsAdd a remote MCP server (connector) with the URL https://lasaladita.com/mcp. No authentication.
JSON config (Cursor, VS Code and others){"mcpServers":{"lasaladita":{"type":"http","url":"https://lasaladita.com/mcp"}}}

Tools: get_surf_forecast, get_tides, get_weather, get_tropical_storms, get_nearby_spots, search_species, get_species, list_findings, search_pages, list_art. The server is stateless and speaks protocol versions 2026-07-28, 2025-11-25, 2025-06-18 and 2025-03-26. Discovery: https://lasaladita.com/.well-known/ai-catalog.json and the server card at https://lasaladita.com/mcp/server-card. The same attribution terms apply.

curl -s https://lasaladita.com/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_surf_forecast","arguments":{"days":2}}}'

Terms and attribution

Free for personal, research, editorial and commercial use. Please attribute as “La Saladita Field Guide, lasaladita.com” with a link, and keep the upstream credits that the responses carry (Open-Meteo, NHC, iNaturalist observers and their photo licenses, IUCN, ERDDAP, USGS). Be reasonable with request rates: the forecast is recomputed at most hourly, so cache it. If you build something with it, the author would like to hear about it.

Cite as: “La Saladita Data API”, La Saladita Field Guide, lasaladita.com/api/.