Beta
These docs are in progress. Some pages are incomplete or may change. Report a problem
Developer docs
MCP server
Overview of the DTPR MCP server — endpoint, tools, resources, prompts, envelope semantics.
Developer docs menu
The DTPR MCP server exposes the DTPR schema, datachain validation, datachain rendering, icon URL resolution, and the DTPR Agent Skills as Model Context Protocol tools, resources, and prompts. It is hosted at:
POST https://api.dtpr.io/mcp
It implements a read-only subset of the MCP Streamable HTTP transport (spec version 2025-06-18) plus MCP Apps (SEP-1865) for the render flow.
In this section
- Connecting — endpoint,
mcp-session-idheader, wire format, batching. - Envelope —
ok/errpayloads,_meta.content_hash, soft-failure semantics. - Resources — the
ui://dtpr/datachain/view.htmlMCP App resource. - Tools — the 12-tool registry, one page each.
- Prompts — the seven DTPR Agent Skills plus their reference documents, served as MCP prompts so any MCP-aware harness can load them without a Claude-specific install.
Tools at a glance
| Tool | Purpose |
|---|---|
list_schema_versions | Discover available schema releases. |
get_schema | Manifest for a single schema version. |
list_categories | Categories within a schema version. |
list_elements | Paginated element list with filters. |
get_element | Single element with icon variants + symbol. |
get_elements | Bulk fetch, up to 100 element ids. |
validate_datachain | Validate a datachain instance; soft-failure. |
render_datachain | Render a datachain + hand off to an iframe via resources/read. |
get_icon_url | Resolve a composed-icon SVG URL. |
resolve_datachain | Bundle a datachain with the categories and elements it uses. |
validate_resolved | Validate a resolved datachain against its schema version. |
get_translation_status | Per-locale review status and reviewer flags. |
All tools share the same envelope shape.
Related
- REST API (v2) — the underlying HTTP contract.
- Icon composition — the mental model behind
get_icon_urland the icon REST routes. - Concepts — DTPR vocabulary.