Skip to main content
Public Preview OpenCode is a terminal-based agentic coding tool. It does not support VS Code extensions. Install the MCP Server, Agent Skills, and CLI separately.

​
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

​
Install and configure

1

Configure the MCP Server

In your terminal, run opencode mcp add and configure the following settings:
  • MCP server name: wherobots-mcp-server (or any name you prefer)
  • MCP server type: Remote
  • MCP server URL: https://api.cloud.wherobots.com/mcp/
  • OAuth authentication: No
Set the WHEROBOTS_API_KEY environment variable:
export WHEROBOTS_API_KEY='<your-api-key>'
To persist this across sessions, add the export to your shell profile (e.g., ~/.zshrc or ~/.bashrc).Restart OpenCode after adding the server.
OpenCode requires using a modern terminal emulator for the most optimal experience.
For more information on downloading, installing, and using OpenCode, see Install and Usage sections in the OpenCode documentation.
2

Install Agent Skills

Agent Skills give your AI assistant structured context about Wherobots workflows, APIs, and best practices.
npx skills add -g wherobots/agent-skills
3

Install the CLI (optional)

The Wherobots CLI wraps the full Wherobots API into a single binary for job submission, log streaming, and automation.
gh repo clone wherobots/wbc-cli && cd wbc-cli && ./scripts/install-release.sh
Set your API key (if not already set above):
export WHEROBOTS_API_KEY='<your-api-key>'
Verify the connection:
wherobots api --tree

​
Verify everything works

Ask a test question in OpenCode:
Show me the catalogs in my Organization
If configured correctly, OpenCode will call the Wherobots MCP server (showing a tool such as list_catalogs) and return the catalogs available in your Organization. If you installed the CLI, verify the connection: 
wherobots api --tree
You should see a tree of available CLI commands.

​
Next steps

MCP Server Best Practices

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

MCP Server Demo Videos

Watch the MCP Server automate catalog discovery, spatial queries, and notebook generation.

Agent Skills

Learn more about available skills and installation options.

Agentic Terminal Usage

Use the CLI with OpenCode for natural language job management.

CLI Reference

Submit jobs, stream logs, and access the full Wherobots API.

MCP Server vs CLI

Understand when to use the MCP Server vs. the CLI.