Tools
list_schema_versions
Enumerate DTPR schema versions and their stability.
list_schema_versions
Start here when you don't yet know which version to pin. Every other tool takes a
version argument.Summary
Returns every registered schema version with its stability status (stable / beta) and its content hash. The list mirrors the versions[] array in schemas/index.json.
Input
| Field | Type | Required | Description |
|---|---|---|---|
datachain_type | string | no | Filter to one type, e.g. "ai". Omit to list every version. |
Output
{
"ok": true,
"data": {
"versions": [
{
"id": "ai@2026-04-16-beta",
"status": "beta",
"content_hash": "sha256-…",
"aliases": ["ai@latest"]
}
]
}
}
Errors
| Code | Meaning | Fix |
|---|---|---|
invalid_arguments | datachain_type was not a string. | Pass a string or omit the argument. |
upstream_error | Schema index read failed. | Retry. |
Example
curl -s https://api.dtpr.io/mcp \
-H 'content-type: application/json' \
--data '{
"jsonrpc":"2.0","id":1,
"method":"tools/call",
"params":{
"name":"list_schema_versions",
"arguments":{"datachain_type":"ai"}
}
}'
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_schema_versions",
"arguments": { "datachain_type": "ai" }
}
}