# Verdant

- [Climate data with its evidence intact](https://docs.verdant-ai.com/index.md): Query versioned climate data through one contract, directly from HTTP or an agent.
- [Query real data](https://docs.verdant-ai.com/quickstart.md): Discover coverage and get values directly in the response.
- [Data meaning and reproducibility](https://docs.verdant-ai.com/concepts/data-contract.md): The scientific guarantees behind each request and response.
- [Representation and delivery](https://docs.verdant-ai.com/concepts/delivery.md): Direct values, files and asynchronous work share one data contract.
- [Errors and compatibility](https://docs.verdant-ai.com/concepts/errors.md): Machine-readable failures, limits and retry rules.
- [Acquisition and purchase lifecycle](https://docs.verdant-ai.com/concepts/request-lifecycle.md): The intended contract for work that cannot be answered by a direct query.
- [Connect through MCP](https://docs.verdant-ai.com/agents/mcp.md): Search the docs with Mintlify; query live data with Verdant.
- [Check process health](https://docs.verdant-ai.com/api-reference/service/check-process-health.md): Process/configuration status only. This does not verify database or source-provider connectivity.
- [Acquisition (not enabled)](https://docs.verdant-ai.com/api-reference/service/acquisition-not-enabled.md): Reserved asynchronous acquisition route. Always returns 503; never charges or queues work. Use the direct query endpoint for published demo data. Future quote/payment/request contracts are described separately and are not advertised as callable MCP tools.
- [Discover capabilities](https://docs.verdant-ai.com/api-reference/discovery/discover-capabilities.md): Discover the implemented variables, sources, representations, limits and feature availability. This does not check current source coverage.
- [List datasets](https://docs.verdant-ai.com/api-reference/discovery/list-datasets.md): List published catalog metadata. Demo datasets can be read without payment; paid metadata does not grant data access. Restricted datasets are omitted.
- [Inspect a dataset](https://docs.verdant-ai.com/api-reference/discovery/inspect-a-dataset.md): Inspect an immutable dataset version, including units, actual coverage, source hashes, license, attribution and spatial support.
- [Validate query structure](https://docs.verdant-ai.com/api-reference/queries/validate-query-structure.md): Validate shape, calendar dates and ordered bounds only. A valid request is not a coverage guarantee, quote or purchase. Bounds must be west < east and south < north; period start must not follow end. These cross-field constraints are enforced at runtime.
- [Resolve coverage](https://docs.verdant-ai.com/api-reference/queries/resolve-coverage.md): Check complete published demo coverage for a structured climate query. Returns the selected immutable version and row count, or an explicit unavailable reason. Does not acquire data or charge.
- [Query data directly](https://docs.verdant-ai.com/api-reference/queries/query-data-directly.md): Return climate data directly in the response, with provenance. JSON includes a manifest and data array; CSV returns rows with version, digest and metadata-link headers. Only published public demo data is admitted. No charging, acquisition or missing-to-zero conversion.
- [Read observations](https://docs.verdant-ai.com/api-reference/observations/read-observations.md): Read public demo observations in stable ID order. Native dates and season labels remain distinct; a missing value is null, not zero. Follow nextCursor until null.
- [Read a raster index or tile](https://docs.verdant-ai.com/api-reference/raster/read-a-raster-index-or-tile.md): Only public demo data. Cells are top-down row-major: cells[row * width + col]. NULL is preserved. Affine [a,b,c,d,e,f] maps pixel centers to x=a*(col+.5)+b*(row+.5)+c and y=d*(col+.5)+e*(row+.5)+f.
- [Read one raster cell](https://docs.verdant-ai.com/api-reference/raster/read-one-raster-cell.md): Return one native cell and its spatial metadata. A null value means missing, and its unit and evidence class do not change.

## OpenAPI Specs

- [openapi](/openapi.json)

## Optional

- [Website](https://verdant-ai.com)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.