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 token. Temporarily, use a portal token — a couple of tools (geocoding, saved-location search) are portal-scoped upstream for now; a long-lived API token will cover everything once per-capability permissions land.

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?token=YOUR_WEATHEROPTICS_TOKEN
Authentication
No Auth
Risk checkbox
Check "I understand and want to continue"

The token goes in the URL itself (as the ?token= query parameter), matching how every other WeatherOptics API is called. Replace YOUR_WEATHEROPTICS_TOKEN with your real key:

https://weatheroptics-mcp-312915463979.us-east1.run.app/mcp?token=YOUR_WEATHEROPTICS_TOKEN
Why the token in the URL? ChatGPT's "API Key" auth also works (sends Authorization: Bearer <token>), as does an X-WeatherOptics-Token header, but the ?token= query form mirrors the rest of WeatherOptics and works identically in every MCP client — pick whichever you prefer.

Click Create. The plugin validates by handshaking with the server; if it succeeds you'll see the WeatherOptics tools appear under Actions. What each tool does is documented on the tools reference page.

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