Set Up Wherobots in Other Code OSS Editors

Public Preview Draft The editors on this page are based on Code OSS. The Wherobots VS Code Extension installs in each of them, but the MCP Server and Agent Skills must be configured manually. Installing the extension and Agent Skills works the same way in every editor. Where you add the MCP Server differs by editor.

Editor	Description	CLI command
Windsurf	Code OSS-based editor by Cognition AI with AI-powered development features	`windsurf`
Positron	Code OSS-based editor by Posit designed for data science workflows	`positron`
Antigravity	Code OSS-based editor by Google	`antigravity`
Trae	Code OSS-based editor by ByteDance with AI-powered development features	`trae`
VS Codium	Community-driven, freely-licensed distribution of VS Code	`codium`

These instructions are a preliminary adaptation of the standard VS Code Extension within the Windsurf, Positron, Antigravity, Trae, or VS Codium environment. Users may encounter steps that require manual adjustment. Should you experience any technical difficulties, please contact Wherobots Support for assistance.

Component Overview

Wherobots’ Agentic Tools consist of the following components that work together to provide our agentic experience:

MCP Server

Connects your AI assistant to Wherobots Cloud for catalog exploration, documentation search, read-only Spatial SQL queries, and workload and Spark execution details.

Agent Skills

Gives your AI assistant domain-specific Wherobots knowledge for more accurate commands and fewer errors.

Wherobots CLI

Wraps the full Wherobots API into a single binary for job submission, log streaming, and automation.

Why use Wherobots’ agentic tools?

Wherobots’ agentic tools connect your AI assistant to Wherobots Cloud and your local development environment so you can interact with your spatial data, catalogs, and jobs in a more intuitive way.

Explore your spatial catalog conversationally

The MCP Server connects your AI assistant to Wherobots Cloud so you can browse catalogs, databases, and table schemas (including Overture Maps and your own datasets) by asking questions in plain language instead of navigating the console.

Generate Spatial SQL without memorizing functions

Describe a geospatial task (e.g. “find buildings within 500m of this point”) and your AI assistant writes Spatial SQL with WherobotsDB’s ST functions, using the table schemas and documentation that the MCP Server provides, then runs it on Wherobots Cloud.

Submit and monitor Wherobots jobs from your editor

Use the CLI or the extension to submit Spark job runs, stream logs in real time, check resource metrics, and cancel jobs without leaving your editor or terminal.

Get Wherobots-aware AI assistance

Agent Skills teach your AI assistant Wherobots-specific APIs, query patterns, and workflow sequences so it produces correct wherobots CLI commands, valid MCP tool calls, and accurate notebook code on the first try.

Before you start

One of the editors above installed.
A Wherobots Account. See Create a Wherobots Account.
Organization Availability: Available to all Wherobots Organization Editions (Professional, Innovation, and Enterprise).
An AI assistant in your editor (for AI-assisted features). In Windsurf, that’s an active Windsurf AI subscription; in the other editors, an AI assistant extension.
Node.js and npm installed on your system (required for installing Agent Skills via npx).

Install the extension

Run the command for your editor in your terminal:

windsurf --install-extension Wherobots.wherobotsjobsubmit

positron --install-extension Wherobots.wherobotsjobsubmit

antigravity --install-extension Wherobots.wherobotsjobsubmit

trae --install-extension Wherobots.wherobotsjobsubmit

codium --install-extension Wherobots.wherobotsjobsubmit

Or install from the Open VSX Registry.

If your editor prompts you to install a missing dependency extension (e.g., Jupyter), click Install and Reload.

Configure the extension

After installation, connect to Wherobots Cloud by signing in from your browser (OAuth) or setting an API key.

These steps apply to VS Code, Cursor, Windsurf, Kiro, Positron, Antigravity, Trae, VS Codium, and other Code OSS editors. All use the same Command Palette and extension settings.

Open the Command Palette

To open the Command Palette, click the search bar at the top of your editor and type >wherobots:.

You can also press ⌘ + Shift + P on Mac, Ctrl + Shift + P on Windows/Linux to open the Command Palette.

Click Wherobots: Sign In to start the OAuth flow. A browser window opens for you to sign in to Wherobots and select your Organization; when you’re done, return to your editor.To sign out at any time, run Wherobots: Sign Out from the Command Palette.

Prefer an API key? Click Wherobots: Set API Key and enter your existing or newly created Wherobots API key when prompted, then press Enter. If you don’t have a key yet, click Wherobots: Generate API Key on Wherobots Cloud to create one first.

Verify the installation

To confirm the extension is installed and configured correctly:

Open the Command Palette

To open the Command Palette, click the search bar at the top of your editor and type >wherobots:.

You can also press ⌘ + Shift + P on Mac, Ctrl + Shift + P on Windows/Linux to open the Command Palette.

Confirm available commands

Type Wherobots to see the available extension commands. At this point, you should see commands, including:

Wherobots: Sign In
Wherobots: Sign Out
Wherobots: Set API Key
Wherobots: Create Workspace
Wherobots: Submit Job
Wherobots: Refresh Workspaces
Wherobots: Open Settings
Wherobots: Install Jupyter Extension

Configure the MCP Server

Where you add the MCP Server depends on the editor:

Editor	Where to add the MCP Server
Positron	The MCP: Add Server command, as described in Positron and VS Codium. See Posit’s Positron example.
VS Codium	The MCP: Add Server command, if your build has it, as described in Positron and VS Codium. Otherwise, the MCP settings of your AI assistant extension.
Windsurf	`mcp_config.json`, which you open from the Cascade panel: the … menu, then Open MCP config file in the MCPs section. See Windsurf and Antigravity and the Windsurf MCP documentation.
Antigravity	`mcp_config.json`, which you open from the agent panel: … > MCP Servers > Manage MCP Servers > View raw config. See Windsurf and Antigravity and the Antigravity MCP documentation.
Trae	Trae’s MCP settings. See the Trae MCP documentation.

Each editor needs the same two values: the server URL, https://api.cloud.wherobots.com/mcp/, and an x-api-key header with your Wherobots API key.

Positron and VS Codium

The Wherobots MCP Server enables AI assistants to explore your spatial data catalogs, generate Spatial SQL, and execute queries. Configure it manually:

Add the MCP server

Open the Command Palette (⌘ + Shift + P on macOS, Ctrl + Shift + P on Windows/Linux).

Type MCP: Add Server and select it.
Select HTTP (HTTP or Server-Sent Events) as the server type.
Enter the URL: https://api.cloud.wherobots.com/mcp/
Enter a name for the server (e.g., wherobots-mcp-server).

Add your API key

Your mcp.json file opens automatically. Add a headers object with your Wherobots API key:

"servers": {
  "wherobots-mcp-server": {
    "url": "https://api.cloud.wherobots.com/mcp/",
    "type": "http",
    "headers": {
      "x-api-key": "<YOUR_WHEROBOTS_API_KEY>"
    }
  }
}

Save the file.

Reload your editor

Open the Command Palette and select Reload Window.

The extension’s MCP settings, such as query timeout, runtime size, and cloud region, don’t apply to an MCP server that you configure by hand in mcp.json. See Extension Settings.

Windsurf and Antigravity

Windsurf and Antigravity read mcp_config.json, which uses an mcpServers object and a serverUrl field instead of the servers object and url field of VS Code’s mcp.json. Add the Wherobots server:

{
  "mcpServers": {
    "wherobots-mcp-server": {
      "serverUrl": "https://api.cloud.wherobots.com/mcp/",
      "headers": {
        "x-api-key": "<YOUR_WHEROBOTS_API_KEY>"
      }
    }
  }
}

If the file already lists other servers, add the wherobots-mcp-server entry inside the existing mcpServers object. Save the file.

Install Agent Skills

Agent Skills give your AI assistant domain-specific knowledge about Wherobots workflows, APIs, and best practices.

npx skills add -g wherobots/agent-skills

If the Wherobots VS Code Extension is pinned to your sidebar, you can also create a new workspace by clicking the Create Workspace button.

Create Workspace button in the Wherobots sidebar — The Wherobots extension sidebar showing the Create Workspace button. Specific UI details vary by editor.

To pin the Wherobots extension to the sidebar:

Pin the extension

Right-click the Activity Bar (the vertical icon bar on the left side of your editor).A menu will appear showing all available extensions.

Select the extension

To pin the extension, find Wherobots in the list and click on it to ensure it’s checked.

Wherobots extension checked in the Activity Bar — The Activity Bar context menu with the Wherobots extension checked. Specific UI details vary by editor.

Now you’ll have easy access to the extension in your editor’s sidebar.

Verify installation

Open your AI assistant’s chat panel (Cascade in Windsurf).
Select Agent as the chat mode (if available).

Ask a test question:

List the catalogs in my Wherobots Data Hub

If successful, the assistant will call list_catalogs_tool and display your available tables.
Confirm the server appears in the editor’s list of MCP servers. In Positron and VS Codium, open the Command Palette and run MCP: List Servers. In Windsurf, check the MCPs section of the Cascade panel’s … menu. In Antigravity, open Manage MCP Servers.

Next steps

Browse Your Data

Browse catalogs, schemas, and tables in the Data Hub sidebar.

AI-Assisted Notebooks

Create and connect local notebooks to remote Wherobots compute.

Submit Job Runs

Submit Python scripts as Wherobots job runs from your editor.

MCP Server Best Practices

Common tasks, example prompts, and cost considerations for the MCP Server.

Start here

Notebooks

Editors and AI assistants

VS Code extension

MCP server and agent skills

dbt

Apache Airflow

Storage management

Deployment and monitoring

Set Up Wherobots in Other Code OSS Editors

Component Overview

Why use Wherobots’ agentic tools?

Before you start

Install the extension

Configure the extension

Verify the installation

Configure the MCP Server

Positron and VS Codium

Windsurf and Antigravity

Install Agent Skills

Verify installation

Next steps

Browse Your Data

AI-Assisted Notebooks

Submit Job Runs

MCP Server Best Practices

​Component Overview

​Why use Wherobots’ agentic tools?

​Before you start

​Install the extension

​Configure the extension

​Verify the installation

​Configure the MCP Server

​Positron and VS Codium

​Windsurf and Antigravity

​Install Agent Skills

​Verify installation

​Next steps

Browse Your Data

AI-Assisted Notebooks

Submit Job Runs

MCP Server Best Practices

Component Overview

Why use Wherobots’ agentic tools?

Before you start

Install the extension

Configure the extension

Verify the installation

Configure the MCP Server

Positron and VS Codium

Windsurf and Antigravity

Install Agent Skills

Verify installation

Next steps