Organization Availability: Available to all Wherobots Organization Editions.
- Community Edition Organizations can create and run local notebooks against the Tiny and Micro runtimes.
- Professional or Enterprise Organizations are required for job submission, the Wherobots MCP server, and additional compute tiers. For more information, see Upgrade Organization or Organization Editions.
Before you start
- The Wherobots VS Code Extension is installed and configured.
- A Wherobots Account within a Professional or Enterprise Edition Organization. For more information, see Create a Wherobots Account.
- Your data sources are connected to Wherobots through the Wherobots Data Hub, or you have access to the built-in curated datasets.
Browse the Data Hub
The Data Hub panel is in the Wherobots extension sidebar. It displays a tree of all catalogs registered in your Organization, including any data sources you’ve connected and Wherobots’ built-in curated datasets.- Open the Wherobots extension sidebar by clicking the Wherobots icon in the Activity Bar of VS Code or your Code OSS-based editor.
- Expand the Data Hub panel.
- Navigate the tree structure:
- Catalogs are at the top level, labeled as managed or foreign.
- Expand a catalog to see its schemas.
- Expand a schema to see its tables.
To add new data source connections, view table metadata, or delete connections, use the
Wherobots Data Hub in the Wherobots Cloud web console.
For more information, see Wherobots Data Hub.
Create a notebook from your data
Once you can see your data in the Data Hub, use the built-in MCP server through your editor’s AI assistant to create notebooks that query it.The Wherobots MCP Server requires a Professional or Enterprise Organization Edition. Community Edition Organizations do not have access to the Wherobots MCP server.
Start a workspace
If you don’t already have a running workspace, create one by running
Wherobots: Create Workspace from the Command Palette. For more information, see
Workspaces & Usage.Identify the data you want to work with
Browse the Data Hub in the sidebar to find the catalog, schema, and table you want
to query. Note the fully qualified name, for example,
wherobots_open_data.overture_maps_foundation.buildings_building.Open your AI assistant in Agent mode
Open your editor’s AI assistant (e.g. GitHub Copilot Chat in VS Code) and select Agent mode.
Prompt the AI assistant to create a notebook
Ask the assistant to build a notebook using the data you identified. For example:
Create a notebook that loads the buildings table from wherobots_open_data.overture_maps_foundation.buildings_building and
calculates the total building footprint area per city.
The MCP server handles catalog discovery and query execution behind the scenes.
Allow the Wherobots MCP server when prompted.Run the notebook
Open the generated
.ipynb file and run the cells against your workspace. For detailed instructions, see
Run a local notebook against Wherobots compute.Iterate on your analysis
One of the key benefits of having the Data Hub in your editor is the ability to quickly discover and switch between datasets as your analysis evolves. Rather than starting over when your requirements change, you can pivot to a different dataset with a single prompt. For example, suppose you start an analysis using the Microsoft Buildings dataset, but then realize the Overture Maps buildings data has better coverage for your region of interest. Instead of rewriting your notebook, you can:-
Browse the Data Hub to find the Overture Maps tables under
wherobots_pro_data.overture_maps_foundation. -
Ask the AI assistant to switch:
The Microsoft Buildings data doesn’t have the coverage I need. Switch to using the Overture Maps buildings dataset from
wherobots_pro_data.overture_maps_foundationinstead, and re-run the analysis.
- Explore alternatives: Try different datasets for the same analysis without context-switching.
- Refine incrementally: Add filters, join additional tables, or change aggregations with follow-up prompts.
- Validate quickly: Run each iteration against live Wherobots compute to see results immediately.
Next steps
AI-Assisted Notebook Development
Learn more about creating and running notebooks with AI assistance.
Workspaces & Usage
Create, start, stop, and destroy workspaces.
Wherobots Data Hub
Manage catalogs and connections in the Wherobots Cloud web console.

