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

# Set Up Wherobots in ChatGPT

> Configure the Wherobots MCP Server as a custom App in the ChatGPT desktop app or ChatGPT's web interface for AI-assisted geospatial development.

<Badge color="purple">Public Preview</Badge>

[**ChatGPT**](https://chatgpt.com/) is OpenAI's AI assistant, available as a [native desktop app](https://chatgpt.com/download) for macOS and Windows and a [browser-based app](https://chatgpt.com).

Both support MCP integrations through **Apps**, allowing you to connect Wherobots tools directly.

## Component Overview

Wherobots' Agentic Tools consist of the following components that work together to provide our agentic experience:

<AccordionGroup>
  <Accordion title="MCP Server" icon="message-bot">
    Connects your AI assistant to Wherobots Cloud for catalog exploration, Spatial SQL generation, and query execution.
  </Accordion>

  <Accordion title="Agent Skills" icon="brain">
    Gives your AI assistant domain-specific Wherobots knowledge for more accurate commands and fewer errors.
  </Accordion>

  <Accordion title="Wherobots CLI" icon="terminal">
    Wraps the full Wherobots API into a single binary for job submission, log streaming, and automation.
  </Accordion>
</AccordionGroup>

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

<AccordionGroup>
  <Accordion title="Explore your spatial catalog conversationally" icon="book-open">
    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.
  </Accordion>

  <Accordion title="Generate Spatial SQL without memorizing functions" icon="code">
    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.
  </Accordion>

  <Accordion title="Submit and monitor Wherobots jobs from your editor" icon="rocket">
    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.
  </Accordion>

  <Accordion title="Get Wherobots-aware AI assistance" icon="brain">
    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.
  </Accordion>
</AccordionGroup>

## Before you start

The following prerequisites are required:

* A [ChatGPT](https://chatgpt.com) account with an active paid plan (Plus, Pro, Business, or Enterprise).
* A **Wherobots Account** within a Professional, Innovation, or Enterprise Organization. See [Create a Wherobots Account](/get-started/wherobots-cloud/create-account).
* For the desktop flow: [ChatGPT Desktop](https://chatgpt.com/download) installed.

## Install and configure

In ChatGPT, custom MCP servers are added as **Apps**. Each user creates the Wherobots App on their own account. The same steps work in ChatGPT on the web and ChatGPT Desktop.

<Steps>
  <Step title="Open the Apps settings">
    1. In ChatGPT, go to [**Settings > Apps > Advanced settings**](https://chatgpt.com/#settings/Connectors/Advanced).

    2. Enable **Developer mode**.

       This allows you to add custom MCP servers as Apps in ChatGPT.

           <Frame>
             <img src="https://mintcdn.com/wherobots/-xg1VXa7MjWQmfwe/develop/agentic-tools/images/chatgpt-developer-mode.png?fit=max&auto=format&n=-xg1VXa7MjWQmfwe&q=85&s=60b68f8cce75b9688377189dad2dc053" alt="ChatGPT Developer mode toggle in Advanced settings" width="1342" height="902" data-path="develop/agentic-tools/images/chatgpt-developer-mode.png" />
           </Frame>

    3. Go back to [**Settings > Apps**](https://chatgpt.com/#settings/Connectors).

    4. Click **Create app**.

           <Frame caption="Apps settings with the Create app button.">
             <img src="https://mintcdn.com/wherobots/-xg1VXa7MjWQmfwe/develop/agentic-tools/images/chatgpt-apps-create.png?fit=max&auto=format&n=-xg1VXa7MjWQmfwe&q=85&s=296e55c1b94ed3977bda8964d2009499" alt="ChatGPT Apps settings page with the Create app button visible" width="3022" height="1512" data-path="develop/agentic-tools/images/chatgpt-apps-create.png" />
           </Frame>
  </Step>

  <Step title="Configure the Wherobots app">
    In the **New App** form, enter:

    * **Name:** `wherobots` or a name of your choice (e.g. `Wherobots Geospatial Assistant`)
    * **Description** (optional): a short description, such as `AI-assisted geospatial development with Wherobots`
    * **MCP Server URL:** `https://api.cloud.wherobots.com/mcp/`
    * **Authentication:** `OAuth`

    Review the warning about custom MCP servers and tick **I understand and want to continue**, then save the app.

    <Frame caption="New App form configured for the Wherobots MCP Server.">
      <img src="https://mintcdn.com/wherobots/-xg1VXa7MjWQmfwe/develop/agentic-tools/images/chatgpt-new-app-form.png?fit=max&auto=format&n=-xg1VXa7MjWQmfwe&q=85&s=44b919e922017d3d8dc796b549648a0b" alt="ChatGPT New App form with Name, MCP Server URL, and OAuth Authentication fields" width="3022" height="1512" data-path="develop/agentic-tools/images/chatgpt-new-app-form.png" />
    </Frame>
  </Step>

  <Step title="Complete the OAuth flow">
    1. A new browser tab opens to the Wherobots sign-in page.
    2. Sign in to Wherobots, select your Organization from the **Organization access** dropdown, and click **Allow access**.

           <Frame caption="Wherobots Allow screen.">
             <img src="https://mintcdn.com/wherobots/-xg1VXa7MjWQmfwe/develop/agentic-tools/images/chatgpt-allow-screen.png?fit=max&auto=format&n=-xg1VXa7MjWQmfwe&q=85&s=408b55c9ae59d97ce01529c2613acf71" alt="Wherobots Allow screen" style={{ maxWidth: "400px" }} width="944" height="1589" data-path="develop/agentic-tools/images/chatgpt-allow-screen.png" />
           </Frame>
    3. Return to ChatGPT, go to [**Apps**](https://chatgpt.com/#settings/Connectors).

       **Wherobots** now appears under your **Enabled apps** with the `DEV` badge.

           <Frame caption="ChatGPT Apps settings with Wherobots app added.">
             <img src="https://mintcdn.com/wherobots/-xg1VXa7MjWQmfwe/develop/agentic-tools/images/chatgpt-enabled-app.png?fit=max&auto=format&n=-xg1VXa7MjWQmfwe&q=85&s=d7330af6ca472479c50916f3099d81b1" alt="ChatGPT Apps settings page with Wherobots app listed" width="1000" height="386" data-path="develop/agentic-tools/images/chatgpt-enabled-app.png" />
           </Frame>
  </Step>
</Steps>

## Verify installation

Ask a question in ChatGPT:

```text wrap theme={"system"}
List the catalogs in my Wherobots Data Hub
```

If configured correctly, ChatGPT will call the Wherobots MCP server (showing a tool such as `list_catalogs`) and return the catalogs available in your Organization.

<Tip>
  To make sure ChatGPT has the Wherobots MCP server app as context:

  1. Use the Wherobots App in a conversation.
  2. Open the **+** menu in the chat composer.
  3. Click **... More**.
  4. Enable **Wherobots** before sending your prompt.

  <Frame>
    <img src="https://mintcdn.com/wherobots/-xg1VXa7MjWQmfwe/develop/agentic-tools/images/chatgpt-add-wherobots-app.png?fit=max&auto=format&n=-xg1VXa7MjWQmfwe&q=85&s=d633bb892d81ad2a42f635cd5cdae650" alt="ChatGPT chat composer with Wherobots app enabled" width="1570" height="596" data-path="develop/agentic-tools/images/chatgpt-add-wherobots-app.png" />
  </Frame>
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="MCP Server Best Practices" icon="message-bot" href="/develop/mcp/mcp-server-usage">
    Common tasks, example prompts, and cost considerations for the MCP Server.
  </Card>

  <Card title="MCP Server Demo Videos" icon="video" href="/develop/mcp/mcp-server-automating-geospatial-workflows">
    Watch the MCP Server automate catalog discovery, spatial queries, and notebook generation.
  </Card>

  <Card title="Agent Skills" icon="brain" href="/develop/agent-skills">
    Learn more about available skills and installation options.
  </Card>

  <Card title="MCP Server vs CLI" icon="scale-balanced" href="/develop/mcp-vs-cli">
    Understand when to use the MCP Server vs. the CLI.
  </Card>
</CardGroup>