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

# Wherobots MCP Server

> Learn about the Wherobots MCP server for geospatial data exploration and query generation.

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.

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/4_AFhkjhflk?start=30" title="Wherobots MCP Server setup and usage tutorial video" allow="accelerometer; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

## 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.
  <Warning>
    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](/get-started/wherobots-cloud/create-account) first.
  </Warning>
* **API key** (VS Code Extension, Kiro, and other Code OSS editors) — The Wherobots VS Code Extension uses your [Wherobots API key](/get-started/wherobots-cloud/api-keys/) 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](/get-started/wherobots-cloud/create-account).

  * Both **Admin** and **User** roles have access to **MCP Server** in Wherobots Cloud.

  <Note>
    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](mailto:support@wherobots.com).
  </Note>

  <Info>
    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.
  </Info>

## Set up the MCP server

For step-by-step setup instructions for your editor or terminal, see [Get Started with Agentic Development](/develop/agentic-tools). 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.

<CardGroup cols={3}>
  <Card title="VS Code" icon="code" href="/develop/agentic-tools/vscode">
    Code Editor experience with OAuth or API key authentication.
  </Card>

  <Card title="Cursor" icon="arrow-pointer" href="/develop/agentic-tools/cursor">
    AI-powered editor with intelligent code generation and data exploration.
  </Card>

  <Card title="Kiro" icon="wand-magic-sparkles" href="/develop/agentic-tools/kiro">
    AWS' agentic code editor.
  </Card>

  <Card title="Claude Code" icon="terminal" href="/develop/agentic-tools/claude-code">
    Terminal AI assistant for code generation and spatial queries.
  </Card>

  <Card title="OpenCode" icon="terminal" href="/develop/agentic-tools/opencode">
    Open-source terminal assistant for code and data exploration.
  </Card>

  <Card title="Claude (Web & Desktop)" icon="terminal" href="/develop/agentic-tools/claude-desktop-and-web">
    AI assistant for spatial queries in web and desktop apps.
  </Card>
</CardGroup>

<Card title="See all agentic editors, terminal, and web tools" icon="grid-2" horizontal href="/develop/agentic-tools">
  Click for a full list of all supported tools and their Wherobots MCP server integration capabilities.
</Card>

## 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](/develop/vscode-extension/settings) for the full reference.