> ## 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.
# Set Up Wherobots in Antigravity
> Install the Wherobots VS Code Extension in Antigravity and manually configure the MCP Server and Agent Skills for AI-assisted geospatial development.
export const AgenticDraftNotice = ({editor}) =>
These instructions are a preliminary adaptation of the standard VS Code Extension within the {editor} environment. Users may encounter steps that require manual adjustment. Should you experience any technical difficulties, please contact Wherobots Support for assistance.
;
Public Preview Draft
**Antigravity** is a Code OSS-based editor. The Wherobots VS Code Extension installs but MCP Server and Agent Skills must be configured manually.
## Component Overview
Wherobots' Agentic Tools consist of the following components that work together to provide our agentic experience:
Connects your AI assistant to Wherobots Cloud for catalog exploration, Spatial SQL generation, and query execution.
Gives your AI assistant domain-specific Wherobots knowledge for more accurate commands and fewer errors.
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.
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.
Describe a geospatial task (e.g. "find buildings within 500m of this point") and the MCP Server returns optimized Spatial SQL using WherobotsDB's ST functions, spatial joins, and indexing patterns.
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.
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
* [Antigravity](https://antigravity.dev/) installed.
* A **Wherobots Account** within a Community, Professional, or Enterprise Organization. See [Create a Wherobots Account](/get-started/wherobots-cloud/create-account).
**Organization Availability:** Available to all Wherobots Organization Editions.
* **Community Edition Organizations** can create and run local notebooks against the [Tiny and Micro runtimes](/develop/runtimes).
* **Professional or Enterprise Organizations** are required for job submission, the Wherobots MCP server, and additional compute tiers. For more information, see [Upgrade Organization](/get-started/upgrade-organization) or [Organization Editions](/get-started/organization-management/organization-editions).
* An AI assistant extension installed in your editor (for AI-assisted features).
## Install the extension
Run the following command in your terminal:
```bash theme={"system"}
antigravity --install-extension Wherobots.wherobotsjobsubmit
```
Or install from the [Open VSX Registry](https://open-vsx.org/extension/Wherobots/wherobotsjobsubmit).
If Antigravity prompts you to install a missing dependency extension (e.g., Jupyter), click **Install and Reload**.
### Configure the extension
After installation, set your API key to connect to Wherobots Cloud.
These steps apply to VS Code, Cursor, Windsurf, [Kiro](https://kiro.dev/), Positron, Antigravity, Trae, VS Codium, and other Code OSS editors. All use the same Command Palette and extension settings.
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.
1. If you don’t have an API key yet, click `Wherobots: Generate API Key on Wherobots Cloud` to create one.
2. Click `Wherobots: Set API Key` and enter your existing or newly created [Wherobots API key](/get-started/wherobots-cloud/api-keys/) when prompted, then press Enter.
API keys are stored securely in your editor's Secret Storage.
### Verify the installation
To confirm the extension is installed and configured correctly:
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.
Type **Wherobots** to see the available extension commands.
At this point, you should see commands including:
* `Wherobots: Set API Key`
* `Wherobots: Create Workspace`
* `Wherobots: Submit Job`
* `Wherobots: Refresh Workspaces`
* `Wherobots: Open Settings`
* `Wherobots: Install Jupyter Extension`
## Configure the MCP Server
The [Wherobots MCP Server](/develop/mcp/mcp-server-setup) enables AI assistants to explore your spatial data catalogs, generate Spatial SQL, and execute queries. Configure it manually:
Open the **Command Palette** (⌘ + Shift + P on macOS, Ctrl + Shift + P on Windows/Linux).
1. Type **MCP: Add Server** and select it.
2. Select **HTTP (HTTP or Server-Sent Events)** as the server type.
3. Enter the URL: `https://api.cloud.wherobots.com/mcp/`
4. Enter a name for the server (e.g., `wherobots-mcp-server`).
Your `mcp.json` file opens automatically. Add a `headers` object with your Wherobots API key:
```json theme={"system"}
"servers": {
"wherobots-mcp-server": {
"url": "https://api.cloud.wherobots.com/mcp/",
"type": "http",
"headers": {
"x-api-key": ""
}
}
}
```
Save the file.
Open the **Command Palette** and select **Reload Window**.
The extension exposes optional settings for the MCP server — including query timeout, runtime size, and cloud region. See [Configure MCP server settings](/develop/mcp/mcp-server-setup#configure-mcp-server-settings).
## Install Agent Skills
[Agent Skills](/develop/agent-skills) give your AI assistant domain-specific knowledge about Wherobots workflows, APIs, and best practices.
```bash theme={"system"}
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.
To pin the Wherobots extension to the sidebar:
Right-click the **Activity Bar** (the vertical icon bar on the left side of your editor).
A menu will appear showing all available extensions.
To pin the extension, find **Wherobots** in the list and click on it to ensure it's checked.
Now you'll have easy access to the extension in your editor's sidebar.
## Verify everything works
1. Open your AI assistant's chat panel.
2. Select **Agent** as the chat mode (if available).
3. Ask a test question:
> Show me the catalogs in my Organization
4. If successful, the assistant will call `list_catalogs` and display your available catalogs.
5. Open the **Command Palette** and type **MCP: List Servers** to confirm the server appears.
## Next steps
Browse catalogs, schemas, and tables in the Data Hub sidebar.
Create and connect local notebooks to remote Wherobots compute.
Submit Python scripts as Wherobots job runs from your editor.
Common tasks, example prompts, and cost considerations for the MCP Server.