Tools
get_schema
Fetch the manifest, categories, and optionally all elements for one schema version.
get_schema
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. "ai@2026-04-16-beta". |
include | "manifest" | "full" | no | "manifest" | "full" inlines every element. |
Output
{
"ok": true,
"data": {
"version": "ai@2026-04-16-beta",
"manifest": { "content_hash": "sha256-…", "status": "beta", "title": [...], "description": [...] },
"datachain_type": { "id": "ai", "categories": [...] },
"categories": [ { "id": "purpose", "name": [...], "description": [...] } ],
"schema_json": { "...": "..." }
},
"meta": {
"content_hash": "sha256-…",
"version": "ai@2026-04-16-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":"ai@2026-04-16-beta"}
}
}'
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_schema",
"arguments": { "version": "ai@2026-04-16-beta", "include": "full" }
}
}
See also
- REST
GET /schemas/:version/manifest list_categories,list_elements— narrower reads.- Content hash