set_preferences
Configure session preferences for the Nexus-MCP server to control execution mode, model selection, retry behavior, and output limits for subsequent AI agent calls.
Instructions
Set session-scoped preferences that apply to subsequent prompt/batch_prompt calls.
Preferences persist for the duration of the MCP session. 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
Args: execution_mode: Default execution mode for this session ('default' or 'yolo'). None retains the current session value (use clear_execution_mode=True to reset). model: Default model name for this session (e.g. 'gemini-2.5-flash'). None retains the current session value (use clear_model=True to reset). max_retries: Default max retry attempts for transient errors. None retains the current session value (use clear_max_retries=True to reset). output_limit: Default max output bytes per response. None retains the current session value (use clear_output_limit=True to reset). timeout: Default subprocess timeout in seconds. None retains the current session value (use clear_timeout=True to reset). retry_base_delay: Default base delay seconds for exponential backoff. None retains the current session value (use clear_retry_base_delay=True to reset). retry_max_delay: Default max delay cap seconds for exponential backoff. None retains the current session value (use clear_retry_max_delay=True to reset). clear_execution_mode: If True, resets execution_mode to None regardless of the execution_mode argument. clear_model: If True, resets model to None regardless of the model argument. clear_max_retries: If True, resets max_retries to None regardless of the argument. clear_output_limit: If True, resets output_limit to None regardless of the argument. clear_timeout: If True, resets timeout to None regardless of the argument. clear_retry_base_delay: If True, resets retry_base_delay to None. clear_retry_max_delay: If True, resets retry_max_delay to None. ctx: MCP context (auto-injected by FastMCP).
Returns: Confirmation string with the active preferences as JSON.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| execution_mode | No | ||
| model | No | ||
| max_retries | No | ||
| output_limit | No | ||
| timeout | No | ||
| retry_base_delay | No | ||
| retry_max_delay | No | ||
| clear_execution_mode | No | ||
| clear_model | No | ||
| clear_max_retries | No | ||
| clear_output_limit | No | ||
| clear_timeout | No | ||
| clear_retry_base_delay | No | ||
| clear_retry_max_delay | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |