type-get-json-schema

star 3.2k

Generate a JSON Schema for a C# type name via reflection. Supports primitives, enums, arrays, generic collections, dictionaries, and complex objects. Knobs control inclusion of nested `$defs` and whether type-level / property-level descriptions are emitted.

IvanMurzak By IvanMurzak schedule Updated 5/19/2026

name: type-get-json-schema description: Generate a JSON Schema for a C# type name via reflection. Supports primitives, enums, arrays, generic collections, dictionaries, and complex objects. Knobs control inclusion of nested $defs and whether type-level / property-level descriptions are emitted.

Type / Get Json Schema

Generates a JSON Schema for a given C# type name using reflection. Supports primitives, enums, arrays, generic collections, dictionaries, and complex objects. The type must be present in any loaded assembly. Use the full type name (e.g. 'UnityEngine.Vector3') for best results.

Inputs

  • typeName — full type name preferred (e.g. UnityEngine.Vector3, System.Collections.Generic.List<System.Int32>). Simple names work when unambiguous.
  • descriptionMode (default Ignore) — controls type-level description: Include keeps it on the target only, IncludeRecursively also keeps it inside $defs, Ignore strips all.
  • propertyDescriptionMode (default Ignore) — controls property/field/item description: Include keeps on the target's own properties/items only, IncludeRecursively also keeps inside $defs, Ignore strips all.
  • includeNestedTypes (default false) — when true, complex nested types are extracted into $defs and referenced via $ref. Useful for recursive or large types.
  • writeIndented (default false) — pretty-print the output JSON.

How to Call

unity-mcp-cli run-tool type-get-json-schema --input '{
  "typeName": "string_value",
  "descriptionMode": "string_value",
  "propertyDescriptionMode": "string_value",
  "includeNestedTypes": false,
  "writeIndented": false
}'

For complex input (multi-line strings, code), save the JSON to a file and use:

unity-mcp-cli run-tool type-get-json-schema --input-file args.json

Or pipe via stdin (recommended):

unity-mcp-cli run-tool type-get-json-schema --input-file - <<'EOF'
{"param": "value"}
EOF

Troubleshooting

If unity-mcp-cli is not found, either install it globally (npm install -g unity-mcp-cli) or use npx unity-mcp-cli instead. Read the /unity-initial-setup skill for detailed installation instructions.

Input

Name Type Required Description
typeName string Yes Full C# type name to generate the schema for. Examples: 'System.String', 'UnityEngine.Vector3', 'System.Collections.Generic.List<System.Int32>'. Simple names like 'Vector3' are also accepted when unambiguous.
descriptionMode string No Controls the type-level 'description' field. Include: keep on the target type only. IncludeRecursively: keep on the target type and inside $defs entries. Ignore: strip all type-level descriptions. Default: Ignore.
propertyDescriptionMode string No Controls 'description' fields on properties, fields, and array items. Include: keep on the target type's own properties/items only. IncludeRecursively: keep on all properties/items including those inside $defs entries. Ignore: strip all property/item descriptions. Default: Ignore.
includeNestedTypes boolean No When true, complex nested types are extracted into '$defs' and referenced via '$ref' instead of being inlined. Useful for large or recursive types. Default: false.
writeIndented boolean No Whether to format the output JSON with indentation for readability. Default: false.

Input JSON Schema

{
  "type": "object",
  "properties": {
    "typeName": {
      "type": "string"
    },
    "descriptionMode": {
      "type": "string",
      "enum": [
        "Include",
        "IncludeRecursively",
        "Ignore"
      ]
    },
    "propertyDescriptionMode": {
      "type": "string",
      "enum": [
        "Include",
        "IncludeRecursively",
        "Ignore"
      ]
    },
    "includeNestedTypes": {
      "type": "boolean"
    },
    "writeIndented": {
      "type": "boolean"
    }
  },
  "required": [
    "typeName"
  ]
}

Output

Output JSON Schema

{
  "type": "object",
  "properties": {
    "result": {
      "type": "string"
    }
  },
  "required": [
    "result"
  ]
}
Install via CLI
npx skills add https://github.com/IvanMurzak/Unity-MCP --skill type-get-json-schema
Repository Details
star Stars 3,182
call_split Forks 292
navigation Branch main
article Path SKILL.md
More from Creator