> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wherobots.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Extension Settings

> Reference for all Wherobots VS Code Extension settings including MCP server, job submission, and Jupyter integration.

The Wherobots VS Code extension exposes several settings that control MCP server, job submission, and Jupyter integration behavior. To view them, open your editor's **Settings** (<kbd>Cmd+,</kbd> on Mac, <kbd>Ctrl+,</kbd> on Windows/Linux) and search for `@ext:Wherobots.wherobotsjobsubmit`.

## MCP Server

<ParamField path="wherobotsjobsubmit.mcpServerEnabled" type="boolean" default="true">
  Enable or disable the Wherobots MCP server. When enabled, AI assistants like GitHub Copilot can use Wherobots tools.
</ParamField>

<ParamField path="wherobotsjobsubmit.mcpServerQueryTimeout" type="integer" default="900">
  Timeout in seconds for Wherobots MCP server queries. Leave unset to use the server default of 900 seconds (15 minutes).
</ParamField>

<ParamField path="wherobotsjobsubmit.mcpServerRuntimeId" type="string">
  Runtime size for Wherobots MCP server queries (e.g., `TINY`, `SMALL`, `MEDIUM`, `LARGE`). Controls the compute resources allocated. Leave empty to use the server default.
</ParamField>

<ParamField path="wherobotsjobsubmit.mcpServerRuntimeRegion" type="string">
  Cloud region for Wherobots MCP server queries (e.g., `AWS_US_WEST_2`, `AWS_US_EAST_1`). Leave empty to use the server default.
</ParamField>

<Tip>
  Consider increasing **Mcp Server Runtime ID** when running queries against large datasets, and adjust **Mcp Server Query Timeout** if long-running spatial queries are timing out before completion.
</Tip>

### Change the MCP server runtime size

To allocate more compute resources for MCP server queries (for example, when working with large datasets):

1. Open **Settings** (<kbd>Cmd+,</kbd> on Mac, <kbd>Ctrl+,</kbd> on Windows/Linux).
2. Search for `wherobotsjobsubmit.mcpServerRuntimeId`.
3. Set the value to the desired size: `TINY`, `SMALL`, `MEDIUM`, or `LARGE`.
4. Reload the editor window (**Command Palette** → **Reload Window**) for the change to take effect.

Larger runtimes provide more memory and CPU for query execution, which can improve performance and prevent timeouts on complex spatial queries.

### Change the MCP server query timeout

The default query timeout is 900 seconds (15 minutes). Increase this if you run complex spatial joins, aggregations over large datasets, or multi-step queries that the AI agent generates — these can exceed the default limit and fail with a timeout error.

1. Open **Settings** (<kbd>Cmd+,</kbd> on Mac, <kbd>Ctrl+,</kbd> on Windows/Linux).
2. Search for `wherobotsjobsubmit.mcpServerQueryTimeout`.
3. Enter the desired timeout in seconds (e.g., `1800` for 30 minutes).
4. Reload the editor window (**Command Palette** → **Reload Window**) for the change to take effect.

## Job Submission

<ParamField path="wherobotsjobsubmit.instanceSize" type="string">
  Instance size for Wherobots job runs, selected from the available options. If not set, uses the organization's default instance type.
</ParamField>

<ParamField path="wherobotsjobsubmit.region" type="string">
  Cloud region for Wherobots job submission. If not set, uses the organization's region. Note: Some regions are Enterprise-only.
</ParamField>

<ParamField path="wherobotsjobsubmit.scriptPath" type="string">
  Cloud path (e.g., `s3://bucket/path/`) where Wherobots will store scripts when submitting jobs. If not set, uses the organization's default path.
</ParamField>

<ParamField path="wherobotsjobsubmit.timeout" type="integer" default="3600">
  Timeout in seconds for Wherobots Jobs. Default is 1 hour (3600 seconds).
</ParamField>

## General

<ParamField path="wherobotsjobsubmit.apiBaseUrl" type="string" default="https://api.cloud.wherobots.com">
  Override the Wherobots API base URL. Affects both job submission and the MCP server. Leave empty to use the default production server.
</ParamField>

<ParamField path="wherobotsjobsubmit.jupyterIntegrationEnabled" type="boolean" default="true">
  Enable or disable Jupyter integration. When enabled, running Wherobots workspaces appear as kernel options in the VS Code Jupyter kernel picker.
</ParamField>