Setup tutorial · Examples · Tools reference

WeatherOptics MCP Beta Setup

Wire the WeatherOptics MCP server into ChatGPT or Claude so you can ask natural-language questions about weather risk, forecasts, routes, and severe weather for your asset locations — including inline maps.

Before you start

You need:

  1. A ChatGPT or Claude account — any plan works, including Free.
  2. Your WeatherOptics login (the email + password you use for the portal). There's no token to copy — you'll sign in with WeatherOptics during setup and choose exactly which capabilities to share.
If the sign-in flow reports that MCP access is disabled for your organization, ask your WeatherOptics contact to enable it — it's a per-organization setting.

1 Enable Developer Mode

Open ChatGPT → Settings → Plugins → Advanced. Turn on Developer mode.

The Plugins entry in ChatGPT's Settings menu

ChatGPT will warn you this is elevated risk — that's expected. Confirm to enable.

2 Create the plugin

Open the Browse Plugins page (chatgpt.com/plugins) and click the plus (+) button at the top right, next to the plugin search bar, to add a new plugin.

Browse Plugins search bar with the + (add plugin) button at its right

Fill in the form like this:

Name
WeatherOptics MCP
Description
optional — e.g. "7-day weather risk for asset locations"
Connection
Server URL
Server URL
https://weatheroptics-mcp-312915463979.us-east1.run.app/mcp
Authentication
OAuth
Risk checkbox
Check "I understand and want to continue"
https://weatheroptics-mcp-312915463979.us-east1.run.app/mcp
Leave any OAuth client ID/secret fields empty — ChatGPT discovers the WeatherOptics sign-in flow from the server automatically.

Click Create.

3 Connect your WeatherOptics account

Click Connect on the plugin. A WeatherOptics sign-in page opens: enter your login email + password, then choose which capabilities to share with ChatGPT — weather & risk data, route planning, and/or your saved assets. You can grant everything or just a subset.

Once connected, the WeatherOptics tools appear under Actions — only the ones your granted permissions cover. What each tool does is documented on the tools reference page. To change what's shared later, disconnect and reconnect the plugin — the permission picker runs again.

4 Test it in a new chat

Open a new chat, attach an asset CSV (or just name a place), and ask:

Using WeatherOptics, which of my attached warehouses are at risk over the next 7 days?

Maps render directly inline in the chat — try:

Using WeatherOptics, show me an interactive road-risk map around Chicago.

Getting updates

Whenever the WeatherOptics team ships a server update, refresh the plugin so ChatGPT picks it up: Settings → Plugins → the WeatherOptics plugin → scroll down past the tool listings to the "Information" section (the one showing "Connected on" and the server URL) → click Refresh at the top right of that section.

The plugin's Information section showing Connected on and URL, with the Refresh button at the top right

This matters especially for the inline map: ChatGPT caches the map widget template the first time it fetches it and reuses it across chats, so widget changes do not appear until you do this refresh.