catdb.aiDeveloper docsMain site

developer interfaces / one contract

Build against your domain model.

Use CatDB through the TypeScript SDK, REST API, or MCP. Every interface follows the same versioned schemas, mappings, policy checks, and provenance records.

These query examples are reads. Source records remain unchanged; the separate catdb.apply operation changes CatDB-managed workspace state only.

developer workflow / one query contract

Use the same query across three interfaces.

Start with the TypeScript SDK, or choose REST API or MCP for the same EntityQueryRequest and EntityQueryResponse contract.

TypeScript SDK

Query with generated types and the @catdb/client entityQuery method.

Read guide

REST API

Send the same EntityQueryRequest through the authenticated OpenAPI endpoint.

Read guide

MCP

Call the registered catdb.entity_query tool with the shared EntityQueryRequest DTO.

Read guide