MCP server
MCP server
Overview of the DTPR MCP server — endpoint, tools, resources, prompts, envelope semantics.
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 9-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 and aliases. |
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. |
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.