Skip to main content

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.

The Wherobots Cloud Model Context Protocol (MCP) Server allows you to use AI assistants like GitHub Copilot to answer questions about the physical world. This feature enables intelligent catalog exploration, code generation and query execution directly in your development environment. The MCP server is ideal for exploratory data analysis, spatial query generation, and co-authoring production code alongside a human expert.

​
Benefits

The MCP Server integration in Wherobots Cloud allows for:
  • Intelligent Catalog Exploration: Discover and understand the schemas of your available datasets through natural language queries
  • Geospatial Query Generation: Generate Spatial SQL queries using natural language
  • Conversational Exploration: Query your spatial catalog with natural language to speed up preliminary data analysis.

​
Watch a 10-minute demo

​
Authentication

The Wherobots MCP Server supports two authentication methods:
  • OAuth (Cursor, Claude, ChatGPT, Codex, Claude Code, OpenCode) — When you connect for the first time, your MCP client opens a browser window where you sign in to Wherobots and select your organization.
  • API key (VS Code Extension, Kiro, and other Code OSS editors) — The Wherobots VS Code Extension uses your Wherobots API key set through the extension’s Command Palette. Editors that don’t support OAuth use API keys in mcp.json headers. API keys are also accepted alongside OAuth in tools that support both.
OAuth sign-in requires an existing Wherobots account. You cannot create a new account through the OAuth flow. If you don’t have an account yet, create one at cloud.wherobots.com first.

​
Before you start

Before using this feature, ensure that you have the following required resources:
  • An Account within a Professional or Enterprise Organization. For more information, see Create a Wherobots Account.
    • Both Admin and User roles have access to MCP Server in Wherobots Cloud.
    The Wherobots MCP server is hosted in us-west-2. When used, MCP clients communicate with this service.If you need the MCP server to be hosted in alternative regions, please file a request at support@wherobots.com.
    Using the MCP Server with the most advanced versions of AI models like Claude Sonnet, Claude Opus, or GPT Codex is recommended for optimal performance.

​
Set up the MCP server

For step-by-step setup instructions for your editor or terminal, see Get Started with Agentic Development. It covers VS Code, Cursor, Kiro, Windsurf, Claude Code, OpenCode, and more.

​
Configure MCP server settings

The Wherobots VS Code extension exposes optional settings for the MCP server — including query timeout, runtime size, and cloud region. See Extension Settings for the full reference.

​
Select your tool

The Wherobots MCP server can be used in a variety of environments, including code editors, terminal-only tools, and web-based LLM interfaces.

VS Code

Code Editor experience with OAuth or API key authentication.

Cursor

AI-powered editor with intelligent code generation and data exploration.

Kiro

AWS’ agentic code editor.

Claude Code

Terminal AI assistant for code generation and spatial queries.

OpenCode

Open-source terminal assistant for code and data exploration.

Claude (Web & Desktop)

AI assistant for spatial queries in web and desktop apps.

See all agentic editors, terminal, and web tools

Click for a full list of all supported tools and their Wherobots MCP server integration capabilities.