data
DestructiveIdempotent
Read, modify, or delete data in JSON, YAML, or TOML files using get, set, and delete operations.
Instructions
Get, set, or delete data in JSON, YAML, or TOML files.
Use when you need to get, set, or delete specific values or entire sections in a structured data file.
Output contract: Returns {"success": bool, "result": Any, "file": str, ...}. Side effects: Modifies file on disk if operation is 'set' or 'delete'. Failure modes: FileNotFoundError if file missing. ToolError if format disabled or invalid JSON.
Operations:
get: Retrieve data, schema, or structure
set: Update/create value at key_path (always writes to file)
delete: Remove key/element at key_path (always writes to file)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| value | No | Value to set as JSON string (required for operation='set') | |
| cursor | No | Pagination cursor | |
| key_path | No | Dot-separated key path (required for set/delete, optional for get) | |
| data_type | No | Type for get: 'data', 'schema', or 'meta' (server info) | data |
| file_path | Yes | Path to file | |
| operation | Yes | Operation: 'get', 'set', or 'delete' | |
| value_type | No | How to interpret the value parameter for SET operations. 'string': treat value as literal string (no JSON parsing). 'number': parse value as JSON number. 'boolean': parse value as JSON boolean. 'null': set to null/None (value parameter ignored). 'json' or None (default): parse value as JSON (current behavior, maintains backward compatibility). | |
| return_type | No | Return type for get: 'keys' (structure) or 'all' (full data) | all |
| output_format | No | Output format | |
| document_index | No | Optional YAML document index for multi-document files (0-based) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |