Clean up MCP tool schemas so $ref objects stand alone without sibling description fields.
Context:
clas_trust_verify is conceptually valid, but for protocol-clean JSON Schema/MCP compatibility the outputSchema object should be only:
"outputSchema": {
"$ref": "./verify.receipt.schema.json"
}
Do not keep description as a sibling beside $ref, because some JSON Schema/MCP tooling treats $ref as replacing the whole object and may ignore or reject siblings.
Task:
- Inspect all files matching:
schemas/trust-verification/*/*.mcp.tool.schema.json
- Find any
inputSchema or outputSchema objects where $ref has sibling fields such as description.
- Remove sibling fields beside
$ref from those schema ref objects.
- Keep top-level tool
description fields intact.
- Do not modify request schemas, receipt schemas, OpenAPI files, examples, or manifest unless necessary.
- Validate every MCP tool schema parses as JSON.
- Run available validation scripts, including
npm run validate:trust-verification if applicable.
Expected clean pattern:
{
"name": "clas_trust_verify",
"title": "CLAS Trust Verify",
"description": "Verify a claim, artifact, receipt, credential, identity, or action. Successful execution returns a CLAS verify receipt.",
"inputSchema": {
"$ref": "./verify.request.schema.json"
},
"outputSchema": {
"$ref": "./verify.receipt.schema.json"
},
"annotations": {
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true
}
}
Report:
- files changed
- any ref siblings removed
- validation results
- any remaining issues
Clean up MCP tool schemas so
$refobjects stand alone without siblingdescriptionfields.Context:
clas_trust_verifyis conceptually valid, but for protocol-clean JSON Schema/MCP compatibility theoutputSchemaobject should be only:Do not keep
descriptionas a sibling beside$ref, because some JSON Schema/MCP tooling treats$refas replacing the whole object and may ignore or reject siblings.Task:
schemas/trust-verification/*/*.mcp.tool.schema.jsoninputSchemaoroutputSchemaobjects where$refhas sibling fields such asdescription.$reffrom those schema ref objects.descriptionfields intact.npm run validate:trust-verificationif applicable.Expected clean pattern:
{ "name": "clas_trust_verify", "title": "CLAS Trust Verify", "description": "Verify a claim, artifact, receipt, credential, identity, or action. Successful execution returns a CLAS verify receipt.", "inputSchema": { "$ref": "./verify.request.schema.json" }, "outputSchema": { "$ref": "./verify.receipt.schema.json" }, "annotations": { "readOnlyHint": true, "destructiveHint": false, "idempotentHint": true, "openWorldHint": true } }Report: