# TraceDB Documentation

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.trace-db.com/_mcp/server

## Docs

- [Overview](https://docs.trace-db.com/start/overview.md)
- [Hosted Alpha](https://docs.trace-db.com/start/hosted-alpha.md)
- [Quickstarts](https://docs.trace-db.com/start/quickstarts.md)
- [Boundaries](https://docs.trace-db.com/start/boundaries.md)
- [Feature Matrix](https://docs.trace-db.com/start/feature-matrix.md)
- [SDK Strategy](https://docs.trace-db.com/sd-ks/sdk-strategy.md)
- [CLI Prototype](https://docs.trace-db.com/sd-ks/cli-prototype.md)
- [TraceQL](https://docs.trace-db.com/query/trace-ql.md)
- [Native and Bounded GraphQL](https://docs.trace-db.com/query/native-and-bounded-graph-ql.md)
- [Authentication](https://docs.trace-db.com/api/authentication.md)
- [Errors](https://docs.trace-db.com/api/errors.md)
- [Managed Routing](https://docs.trace-db.com/operations/managed-routing.md)
- [Idempotency and Retries](https://docs.trace-db.com/operations/idempotency-and-retries.md)
- [Storage and Durability](https://docs.trace-db.com/operations/storage-and-durability.md)

## API Docs

- API Reference > Tracedb > admin [Compact local engine state](https://docs.trace-db.com/api-reference/tracedb/admin/post-admin-compact.md)
- API Reference > Tracedb > admin [List admin jobs](https://docs.trace-db.com/api-reference/tracedb/admin/get-admin-jobs.md)
- API Reference > Tracedb > admin [Restore snapshot](https://docs.trace-db.com/api-reference/tracedb/admin/post-admin-restore.md)
- API Reference > Tracedb > admin [Create snapshot](https://docs.trace-db.com/api-reference/tracedb/admin/post-admin-snapshot.md)
- API Reference > Tracedb > catalog [List branches](https://docs.trace-db.com/api-reference/tracedb/catalog/get-branches.md)
- API Reference > Tracedb > catalog [List databases](https://docs.trace-db.com/api-reference/tracedb/catalog/get-databases.md)
- API Reference > Tracedb > query [Explain hybrid query](https://docs.trace-db.com/api-reference/tracedb/query/post-explain.md)
- API Reference > Tracedb > query [Run native GraphQL query, mutation, or admin operation](https://docs.trace-db.com/api-reference/tracedb/query/post-graphql.md)
- API Reference > Tracedb > query [Run bounded GraphQL compatibility query adapter](https://docs.trace-db.com/api-reference/tracedb/query/post-graphql-bounded.md)
- API Reference > Tracedb > query [Export bounded GraphQL schema](https://docs.trace-db.com/api-reference/tracedb/query/get-graphql-schema.md)
- API Reference > Tracedb > query [Run hybrid query](https://docs.trace-db.com/api-reference/tracedb/query/post-query.md)
- API Reference > Tracedb > query [Run native TraceQL query or command](https://docs.trace-db.com/api-reference/tracedb/query/post-traceql.md)
- API Reference > Tracedb > health [Health check](https://docs.trace-db.com/api-reference/tracedb/health/get-health.md)
- API Reference > Tracedb > records [Insert record compatibility route](https://docs.trace-db.com/api-reference/tracedb/records/post-insert.md)
- API Reference > Tracedb > records [Delete record](https://docs.trace-db.com/api-reference/tracedb/records/post-records-delete.md)
- API Reference > Tracedb > records [Get record](https://docs.trace-db.com/api-reference/tracedb/records/post-records-get.md)
- API Reference > Tracedb > records [Patch record](https://docs.trace-db.com/api-reference/tracedb/records/post-records-patch.md)
- API Reference > Tracedb > records [Put record](https://docs.trace-db.com/api-reference/tracedb/records/post-records-put.md)
- API Reference > Tracedb > records [Put record batch](https://docs.trace-db.com/api-reference/tracedb/records/post-records-put-batch.md)
- API Reference > Tracedb > records [Scan records](https://docs.trace-db.com/api-reference/tracedb/records/post-records-scan.md)
- API Reference > Tracedb > metrics [Read public-safe metrics](https://docs.trace-db.com/api-reference/tracedb/metrics/get-metrics-public-safe.md)
- API Reference > Tracedb > readiness [Readiness check](https://docs.trace-db.com/api-reference/tracedb/readiness/get-ready.md)
- API Reference > Tracedb > schema [Apply table schema](https://docs.trace-db.com/api-reference/tracedb/schema/post-schema-apply.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.trace-db.com/openapi.json)
- [OpenAPI YAML](https://docs.trace-db.com/openapi.yaml)