Set Session Preferences
set_preferencesIdempotent
Configure default settings for execution mode, model, retries, timeouts, and other parameters to apply to all subsequent prompt calls until explicitly cleared.
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 |
|---|---|---|---|
| execution_mode | No | Default execution mode ('default' or 'yolo'). None retains the current value (use clear_execution_mode=True to reset). | |
| model | No | Default model name (e.g. 'gpt-5.2'). None retains the current value (use clear_model=True to reset). | |
| max_retries | No | Default max retry attempts for transient errors. None retains the current value (use clear_max_retries=True to reset). | |
| output_limit | No | Default max output bytes per response. None retains the current value (use clear_output_limit=True to reset). | |
| timeout | No | Default subprocess timeout in seconds. None retains the current value (use clear_timeout=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). | |
| 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). | |
| elicit | No | ||
| confirm_yolo | No | ||
| confirm_vague_prompt | No | ||
| confirm_high_retries | No | ||
| confirm_large_batch | No | ||
| clear_execution_mode | No | If True, resets execution_mode to None regardless of the execution_mode argument. | |
| clear_model | No | If True, resets model to None regardless of the model argument. | |
| clear_max_retries | No | If True, resets max_retries to None regardless of the argument. | |
| clear_output_limit | No | If True, resets output_limit to None regardless of the argument. | |
| clear_timeout | No | If True, resets timeout to None regardless of the argument. | |
| clear_retry_base_delay | No | If True, resets retry_base_delay to None. | |
| clear_retry_max_delay | No | If True, resets retry_max_delay to None. | |
| clear_elicit | No | ||
| clear_confirm_yolo | No | ||
| clear_confirm_vague_prompt | No | ||
| clear_confirm_high_retries | No | ||
| clear_confirm_large_batch | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |