Configure Wherobots MCP Server

1. Ensure your editor’s AI assistant is signed in (e.g. GitHub Copilot in VS Code).
2. Open your editor’s Settings (e.g., press Cmd+, on Mac).
3. In the search bar, type mcp.
4. Configure the following settings:
   • Chat Mcp Discovery: Enabled
   • Chat > Mcp > Access: all
   • Chat > Mcp > Autostart: newAndOutdated

​

Add the MCP server

1. Open the VS Code Command Palette (e.g., press Cmd+Shift+P on Mac).
2. Type MCP: Add Server and select it from the list.
3. You will be prompted to “Choose the type of MCP server to add”. Select HTTP (HTTP or Server-Sent Events).
4. When prompted for the URL, enter the service URL: https://api.cloud.wherobots.com/mcp/.
5. When prompted, provide a name for your MCP server (e.g., “wherobots-mcp-server”).
6. Your mcp.json file will open automatically after adding the server. If not, you can open it manually by typing and selecting >mcp: Open User Configuration in the Command Palette.
7. Add a "headers" object containing your "x-api-key", using your Wherobots API key as the value. Copy and paste the following into your mcp.json, replacing the placeholders with your chosen MCP server name and Wherobots API key.
   "servers": {
     "<YOUR_SERVER_NAME>": {
       "url": "https://api.cloud.wherobots.com/mcp/",
       "type": "http",
       "headers": {
         "x-api-key": "<YOUR_WHEROBOTS_API_KEY>"
       }
     }
   }
   
8. Save the mcp.json file.
9. Reload VS Code to apply your changes:
   1. Open the Command Palette (Cmd+Shift+P on Mac, Ctrl+Shift+P on Windows/Linux).
   2. Type and select Reload Window.

​

Start the MCP server

1. Open the Command Palette again and type MCP: List Servers.
   1. Select your server from the list, then click Start Server.
   2. Check the VS Code Output panel to confirm the server has started successfully.
   To find the Output Panel, go to the menu and select View > Output. You should see log entries similar to the following:
   2025-11-14 14:12:46.829 [info] Starting server wherobots-mcp-server
   2025-11-14 14:12:46.831 [info] Connection state: Starting
   2025-11-14 14:12:46.831 [info] Starting server from LocalProcess extension host
   2025-11-14 14:12:46.833 [info] Connection state: Running
   2025-11-14 14:12:47.953 [info] Discovered 8 tools
   

​

Use the MCP server

1. Open your editor’s AI assistant (e.g. GitHub Copilot Chat in VS Code via View > Chat).
2. If you haven’t already, start a new chat session.
3. Make sure you have Agent selected as the chat mode. You can select this from the dropdown menu at the top of the chat panel.
4. You can also select the model you wish to use alongside the MCP server from the adjacent dropdown. Quality of responses may vary between models.
   Wherobots recommends using the latest versions of advanced models like Claude Opus, Claude Sonnet, Gemini 3 Pro, or GPT Codex for optimal performance with the MCP server.
5. Ask a question to see if it interacts with the Wherobots service, for example:

   Show me the catalogs in my Organization

6. If successful, your AI assistant will confirm it is using the Wherobots MCP server (showing Ran list_catalogs or a similar tool) and display all of the available catalogs in your Organization. The exact response will vary depending on the datasets within your Organization as well as the model used to query the MCP server. At minimum, wherobots_open_data appears for Community Edition, and both wherobots_open_data and wherobots_pro_data for Professional and Enterprise Edition Organizations.

​

Stop the MCP server

1. Open the Command Palette (Cmd+Shift+P on Mac, Ctrl+Shift+P on Windows/Linux).
2. Type and select MCP: List Servers.
3. Select the name of your server from the list.
4. Click Stop Server.