# qlim8 Developer API

> qlim8 is a carbon-accounting platform. This site documents its public REST API (`/api/v1`)
> and Model Context Protocol (MCP) server (`/api/mcp`) for programmatic and AI-agent access to
> emissions, activities, reports, targets, value-chain, scenarios and webhooks. Auth is a
> Bearer API key (`qk_live_*` / `qk_sandbox_*`) with per-key scopes, or OAuth 2.1 for MCP
> connectors (Claude/ChatGPT — Dynamic Client Registration, PKCE, admin consent). Errors are
> RFC 9457 Problem Details; lists use opaque cursor pagination; writes accept an
> `Idempotency-Key`.

## Start here

- [Authentication](https://developers.qlim8.com/guides/authentication.md): Bearer keys, scopes, minting, `/me`, third-party keys.
- [Pagination](https://developers.qlim8.com/guides/pagination.md): opaque `next_cursor` loop, limits, inclusive date filters.
- [Idempotency](https://developers.qlim8.com/guides/idempotency.md): `Idempotency-Key` for safe POST/PATCH retries.
- [Errors & rate limits](https://developers.qlim8.com/guides/errors.md): RFC 9457 codes, troubleshooting table, edge + per-key limits, 429 handling.
- [Webhook signing](https://developers.qlim8.com/guides/webhooks-signing.md): `X-Qlim8-Signature: t=…,v1=…` HMAC-SHA256 verification.

## MCP (AI agents)

- [MCP quickstart](https://developers.qlim8.com/mcp-quickstart.md): no-code OAuth connectors for Claude & ChatGPT, plus Claude Code / Desktop / Cursor; 31 tools, 3 resources, 3 prompts; stateless transport; annotations; error model.
- [MCP tools reference](https://developers.qlim8.com/mcp-tools-reference.md): every tool with scope, annotations, input/output.

## Machine-readable

- [OpenAPI spec](https://api.qlim8.com/api/v1/openapi.json): full REST surface (also at `/openapi.json` on the docs host).
- [MCP schema](https://app.qlim8.com/api/mcp/schema): unauthenticated discovery doc — all 31 tools, conventions, read/write split.
- [llms-full.txt](https://developers.qlim8.com/llms-full.txt): single self-contained plaintext reference for ingestion.

## Optional

- [Migration v0 → v1](https://developers.qlim8.com/migration-v0-to-v1.md): legacy `X-API-Key` endpoints → `/api/v1` (sunset 30 Sep 2027).