Set Session Preferences
set_preferencesIdempotent
Define default settings like model, timeout, retry delays, and execution mode for all subsequent prompts. Use clear flags to reset individual fields.
Instructions
Set persistent preferences that apply to subsequent prompt/batch_prompt calls.
Preferences persist across MCP sessions. Call again to update, or use clear_preferences to reset all fields at once.
To clear a single field while keeping others, pass the corresponding clear_* flag: set_preferences(clear_model=True) # clears model, keeps execution_mode
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Default model name (e.g. 'gpt-5.2'). None retains the current value (use clear_model=True to reset). | |
| elicit | No | ||
| timeout | No | Default subprocess timeout in seconds. None retains the current value (use clear_timeout=True to reset). | |
| clear_model | No | If True, resets model to None regardless of the model argument. | |
| max_retries | No | Default max retry attempts for transient errors. None retains the current value (use clear_max_retries=True to reset). | |
| clear_elicit | No | ||
| confirm_yolo | No | ||
| output_limit | No | Default max output bytes per response. None retains the current value (use clear_output_limit=True to reset). | |
| clear_timeout | No | If True, resets timeout to None regardless of the argument. | |
| execution_mode | No | Default execution mode ('default' or 'yolo'). None retains the current value (use clear_execution_mode=True to reset). | |
| retry_max_delay | No | Default max delay cap seconds for exponential backoff. None retains the current value (use clear_retry_max_delay=True to reset). | |
| retry_base_delay | No | Default base delay seconds for exponential backoff. None retains the current value (use clear_retry_base_delay=True to reset). | |
| clear_max_retries | No | If True, resets max_retries to None regardless of the argument. | |
| clear_confirm_yolo | No | ||
| clear_output_limit | No | If True, resets output_limit to None regardless of the argument. | |
| confirm_large_batch | No | ||
| clear_execution_mode | No | If True, resets execution_mode to None regardless of the execution_mode argument. | |
| confirm_high_retries | No | ||
| confirm_vague_prompt | No | ||
| clear_retry_max_delay | No | If True, resets retry_max_delay to None. | |
| clear_retry_base_delay | No | If True, resets retry_base_delay to None. | |
| clear_confirm_large_batch | No | ||
| clear_confirm_high_retries | No | ||
| clear_confirm_vague_prompt | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |