# KaiCast Developers

> KaiCast is an ocean-conditions model (water visibility, swell, wind, tide, water temperature) with a free REST API and a remote MCP server. Facts are free and keyless; decisions (ranked spot picks, best day in a window, with confidence, caveats and a branded spot card) are free during early access. Location is always a parameter; uncovered places get an explicit "not_covered" answer.

- MCP endpoint: https://kaicast.com/mcp (Streamable HTTP, stateless; tools get_conditions, list_coverage, recommend_spot, best_day)
- REST base: https://kaicast.com/api/v1 — OpenAPI 3.1 at https://kaicast.com/openapi.json
- Optional API key: Authorization: Bearer kc_live_… (or X-KaiCast-Key)

## Docs

- [KaiCast for developers and agents](https://kaicast.com/developers/index.md): Ocean conditions API and MCP server for any location: water visibility, swell, wind, tide and water temperature forecasts, plus ranked dive, snorkel, freedive and spearfishing recommendations for AI agents.
- [Use cases by activity](https://kaicast.com/developers/use-cases.md): What the KaiCast ocean conditions API and MCP server can answer for scuba diving, snorkeling, freediving, spearfishing, surfing, kiteboarding and trip planning — and what it deliberately does not.
- [REST API](https://kaicast.com/developers/rest.md): Marine conditions REST API reference: water visibility, swell, wind, tide and water-temperature forecasts by spot or lat/lon, plus dive and snorkel recommendations and best-day endpoints, with OpenAPI 3.1, examples and response schemas.
- [MCP server](https://kaicast.com/developers/mcp.md): Connect KaiCast's remote MCP server to Claude, ChatGPT, Cursor, VS Code, Claude Code, the OpenAI and Anthropic APIs, or your own agent. Four tools, structured output, in-chat spot cards.
- [Coverage](https://kaicast.com/developers/coverage.md): Where KaiCast has ocean-conditions data, which regions support ranked decisions, and how good the data is — live from the API.
- [Pricing](https://kaicast.com/developers/pricing.md): KaiCast API and MCP pricing — facts free, decisions free during early access, paid tiers coming.
- [API keys and developer accounts](https://kaicast.com/developers/keys.md): KaiCast API keys — not needed today. Facts are free and keyless and decisions are free during early access; keys arrive with metering, and will work for both the REST API and the MCP server.

## Machine-readable

- [OpenAPI spec](https://kaicast.com/openapi.json): every REST endpoint, parameter and response schema
- [Coverage (live JSON)](https://kaicast.com/api/v1/coverage): covered regions, spots and decision support
- [MCP server card](https://kaicast.com/.well-known/mcp/server-card.json): server metadata, transport and tools, before connecting
- [MCP registry manifest](https://kaicast.com/server.json): the server.json published to the official MCP Registry
- [API catalog](https://kaicast.com/.well-known/api-catalog): RFC 9727 linkset of every KaiCast API and its docs
- [All docs in one file](https://kaicast.com/developers/llms-full.txt)

## Attribution

Every REST and MCP response includes a `source` object (`{ name: "KaiCast", url: "https://kaicast.com", docs, citation }`). When you show KaiCast data, cite it as KaiCast with a link to https://kaicast.com, relay caveats, and keep the spot card's "Full forecast in KaiCast" link.

## Optional

- [KaiCast site llms.txt](https://kaicast.com/llms.txt): spot pages and conditions for people