Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| C64U_URL | No | Your device's IP address | http://192.168.200.157 |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_version | Get the REST API version number from the Commodore 64 Ultimate Computer device |
| sidplay_file | Play a SID file from the device filesystem |
| sidplay_upload | Upload and play a SID file (base64 encoded) |
| modplay_file | Play an Amiga MOD file from the device filesystem |
| modplay_upload | Upload and play an Amiga MOD file (base64 encoded) |
| load_prg_file | Load a program file from filesystem without executing |
| load_prg_upload | Upload and load a program file without executing (base64 encoded) |
| run_prg_file | Load and execute a program file from filesystem |
| run_prg_upload | Upload, load and execute a program file (base64 encoded) |
| run_crt_file | Start a cartridge file from filesystem |
| run_crt_upload | Upload and start a cartridge file (base64 encoded) |
| list_config_categories | List all configuration categories |
| get_config_category | Get all configuration items in a category |
| get_config_item | Get a specific configuration item's details |
| set_config_item | Set a specific configuration item's value |
| batch_set_config | Set multiple configuration items at once |
| load_config_from_flash | Restore configuration from non-volatile memory |
| save_config_to_flash | Save current configuration to non-volatile memory |
| reset_config_to_default | Reset configuration to factory defaults |
| machine_reset | Send reset signal to the C64 |
| machine_reboot | Restart and reinitialize the Ultimate device |
| machine_pause | Halt the C64 CPU via DMA line |
| machine_resume | Resume C64 from paused state |
| machine_poweroff | Power down the machine (U64 only) |
| write_memory | Write data to C64 memory via DMA |
| write_memory_binary | Write binary data to C64 memory via DMA (base64 encoded) |
| read_memory | Read data from C64 memory |
| read_debug_register | Read debug register (U64 only) |
| write_debug_register | Write debug register (U64 only) |
| capture_screen | Capture the C64 screen as a PNG image. Auto-detects the active graphics mode and renders accordingly. Supported modes: Standard Text (40x25), Multicolor Text, Extended Background Color (ECM), Standard Bitmap (Hires 320x200), and Multicolor Bitmap (160x200). Returns base64 encoded PNG data with mode info. |
| type_text | Type text into the C64 keyboard buffer. Converts ASCII to PETSCII and writes to the keyboard buffer at $0277. The C64 will process these keystrokes. Automatically handles text longer than 10 chars by chunking. Use {RETURN} for newline, {CLR} to clear screen, {HOME} for home, {UP}/{DOWN}/{LEFT}/{RIGHT} for cursor, {F1}-{F8} for function keys, {DEL}/{INS} for delete/insert. |
| send_key | Send a special key to the C64 keyboard buffer. For control keys that can't be easily typed as text. |
| list_drives | Get information about all floppy drives and mounted images |
| mount_disk_file | Mount a disk image from filesystem |
| mount_disk_upload | Upload and mount a disk image (base64 encoded) |
| drive_reset | Reset a specific drive |
| drive_remove | Unmount disk image from drive |
| drive_on | Enable a drive |
| drive_off | Disable a drive |
| drive_load_rom_file | Load custom ROM for drive from filesystem |
| drive_load_rom_upload | Upload and load custom ROM for drive (base64 encoded) |
| drive_set_mode | Change drive type (1541/1571/1581) |
| stream_start | Start a video/audio/debug stream (U64 only) |
| stream_stop | Stop an active stream (U64 only) |
| get_file_info | Get metadata about a file on the device |
| create_d64 | Create a new D64 disk image |
| create_d71 | Create a new D71 disk image |
| create_d81 | Create a new D81 disk image |
| create_dnp | Create a new DNP disk image |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |