Skip to main content
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

This video demonstrates how the MCP server enables seamless catalog exploration, data introspection, and natural language agentic Q&A within Wherobots Cloud. It also showcases how to leverage the MCP server to automatically generate and validate Jupyter notebooks for large-scale spatial joins and data processing.

​
Authentication methods

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.
    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, follow the instructions to create one at cloud.wherobots.com first.
  • 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.

​
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.

​
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.

​
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.