Free tide data API + MCP server.

REST API

JSON over HTTPS. Three endpoints. OpenAPI 3 spec at /api/v1/openapi.json.

List all places

Flat array of every curated place — slug, name, country, region, lat/lon, canonical URL. Cached 15 min at the edge.

curl https://tideturtle.com/api/v1/places

Fetch a single place

7-day extrema, sun + moon, conditions snapshot. URL is /api/v1/places/{country}/{region}/{slug} — same path shape as the human-readable pages.

curl https://tideturtle.com/api/v1/places/germany/north-sea/sylt

Tides near lat/lon

Returns the closest curated place to the supplied coordinates plus its tide data. Great-circle distance in distanceKm.

curl 'https://tideturtle.com/api/v1/tides?lat=54.9&lon=8.3'

Visitor geolocation

Coarse city-level location from the request's edge headers. Used by the homepage's "tides near you" section — also useful as a standalone IP-geo helper.

curl https://tideturtle.com/api/geo

MCP server (for AI agents)

Model Context Protocol is the open standard Claude, Cursor, and other AI clients use to call tools. TideTurtle ships an HTTP MCP server at /mcp with three tools: list_places, get_place, tides_nearby.

Add to Claude Code / Claude Desktop

Drop this into your MCP client config:

{
  "mcpServers": {
    "tideturtle": {
      "url": "https://tideturtle.com/mcp",
      "transport": "http"
    }
  }
}

Direct JSON-RPC

Initialize the session:

curl -X POST https://tideturtle.com/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize"}'

List available tools:

curl -X POST https://tideturtle.com/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

Call a tool — "find the nearest tides to Sylt":

curl -X POST https://tideturtle.com/mcp \
  -H 'content-type: application/json' \
  -d '{
    "jsonrpc":"2.0","id":3,"method":"tools/call",
    "params":{"name":"tides_nearby","arguments":{"lat":54.9,"lon":8.3}}
  }'