Add spool
add_spoolRecord a new spool in your local filament inventory, capturing material, colour, brand, price and remaining grams. Each entry gets a unique id and is saved to a JSON file on your computer.
Instructions
Record a new spool in the user's local filament inventory.
Use it when the user buys or opens a spool; create_filament_profile can also add one when saving a profile. Each call adds another spool with a new id, stored in a JSON file on this computer. Returns the spool.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"material": "<material>"
},
"name": "add_spool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brand | No | Brand. | |
| notes | No | Free-text notes, e.g. where it's stored or when it was dried. | |
| price | No | Price paid. | |
| total_g | No | Net weight of a full spool in grams. | |
| material | Yes | Material, e.g. 'PLA' or 'PETG'. | |
| colour_hex | No | Colour as '#RRGGBB'. | |
| colour_name | No | Colour name. | |
| remaining_g | No | Grams left now, if not full. | |
| filament_preset | No | Filament preset to print it with. |