Beta

These docs are in progress. Some pages are incomplete or may change. Report a problem

Developer docs

get_schema

Fetch the manifest, categories, and optionally all elements for one schema version.

Developer docs menu

The fastest way to pull an entire schema version in one call. Pair with include="full" when you need every element inline.

Summary

Returns the manifest, datachain-type, and categories for a schema version. Pass include="full" to also inline every element — useful for one-shot agent loads, wasteful for narrow reads.

Input

Field	Type	Required	Default	Description
`version`	`string`	yes	—	Schema version, e.g. `"dtpr@2026-09-01-beta"`.
`include`	`"manifest" \| "full"`	no	`"manifest"`	`"full"` inlines every element.

Output

{
  "ok": true,
  "data": {
    "version": "dtpr@2026-09-01-beta",
    "manifest": { "content_hash": "sha256-…", "status": "beta", "title": [...], "description": [...] },
    "datachain_type": { "id": "dtpr", "categories": [...] },
    "categories": [ { "id": "purpose", "name": [...], "description": [...] } ],
    "schema_json": { "...": "..." }
  },
  "meta": {
    "content_hash": "sha256-…",
    "version": "dtpr@2026-09-01-beta"
  }
}

With include="full" the data object also carries "elements": [...].

Errors

Code	Meaning	Fix
`invalid_arguments`	`version` was missing or malformed.	Provide a canonical version.
`unknown_version`	Version is not registered.	Call `list_schema_versions` and pick a valid id.

Example

curl -s https://api.dtpr.io/mcp \
  -H 'content-type: application/json' \
  --data '{
    "jsonrpc":"2.0","id":1,
    "method":"tools/call",
    "params":{
      "name":"get_schema",
      "arguments":{"version":"dtpr@2026-09-01-beta"}
    }
  }'

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_schema",
    "arguments": { "version": "dtpr@2026-09-01-beta", "include": "full" }
  }
}