MCP server

Tools

The 9 DTPR MCP tools.

Every tool returns the same envelope shape (ok/errors/meta). Canonical schema version in all examples: ai@2026-04-16-beta.

Tool	Purpose	Pagination	Soft-failure
`list_schema_versions`	Discover versions + aliases.	—	—
`get_schema`	Manifest + categories (+ elements) for a version.	—	—
`list_categories`	Category list with locale filtering.	—	—
`list_elements`	Paginated, searchable, projectable element list.	opaque cursor	—
`get_element`	Single element by id.	—	—
`get_elements`	Bulk element read (≤100 ids).	—	per-id
`validate_datachain`	Validate an instance against a version.	—	yes
`render_datachain`	Render an instance + populate the MCP App resource.	—	yes
`get_icon_url`	Resolve a composed-icon REST URL.	—	—

Shared patterns

Version argument — every read tool takes version: string. Accept canonical form ai@YYYY-MM-DD[-beta] or an alias returned by list_schema_versions.
Errors — see Errors for the canonical code list. Common codes: invalid_arguments, unknown_version, element_not_found, unknown_variant, parse_error.
Locale filtering — pass locales: ["en"] (or omit) to keep only specific locales in localized strings.
Field projection — list_elements / get_element / get_elements accept fields: ["id","title",…] or fields: "all".
Pagination — list_elements returns meta.next_cursor when there are more rows. Pass it back as cursor: "…". See REST pagination.