For developers

Conditions data by Guidepole

Live outdoor conditions for your app or AI agent, for any point on the map.

The same data behind Guidepole Fish and Fire: weather, rivers, tides, air quality, smoke and wildfires, answered in one call over a simple REST API or an MCP server.

Get a free API key Quick start

What you can ask

get_conditions

Weather now and ahead, wind, the nearest river gauge and tide (US), plus air quality, smoke and the nearest wildfire (US and Canada).

1 credit per call

get_water_conditions

US river and lake gauges near a point (flow, water temperature, trend) and the nearest US tide station.

1 credit per call

get_fire_situation

The nearest active wildfires with distance, direction, size and containment, whether the point is under smoke, air quality and weather.

2 credits per call

get_fishing_outlook

What's catchable at a lake, river or coast point right now.

1 credit per call

find_waters

US lakes, rivers and streams by name, or waters near a point that hold a species.

1 credit per call

Coverage

Weather, river gauges and tides cover the United States. Air quality, smoke and wildfires cover the United States and Canada.

Plans

Developer

Free

1,000 credits / month

Non-commercial use, 10 calls a minute.

Starter

$29 / month

25,000 credits / month

Commercial use, 60 calls a minute.

Growth

$149 / month

250,000 credits / month

Commercial use, 300 calls a minute.

Enterprise

Custom

Custom volume

Bulk terms and support.

Questions about volume or Enterprise terms: [email protected].

Quick start

Create a key, then call any tool with it.

curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.guidepole.com/api/v1/data/get_conditions/?lat=45.66&lng=-110.56"

Or add it to any MCP client:

{
  "mcpServers": {
    "guidepole-conditions": {
      "url": "https://api.guidepole.com/api/v1/mcp/",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Questions

What's a credit?

Each call costs credits: most tools cost 1, the fire situation costs 2. Calls that fail, or find nothing at the point, are free.

What if a data source is down?

Every answer lists any source that failed under "unavailable", so you can tell "no smoke here" from "the smoke feed is down". We never report an outage as an all-clear. If every source is down, the call is free.

Where does the data come from?

Public sources: NOAA (weather, tides, smoke), USGS (river gauges and water names), EPA AirNow (US air quality, preliminary data) and Environment and Climate Change Canada (Canadian air quality), NIFC and CWFIS (wildfires), and, for fishing outlooks, GBIF species records, verified Guidepole catches and state fish and wildlife regulations. Combined and checked by Guidepole. Every response lists the sources behind the parts it returns.

Can I use it in an AI agent?

Yes. Point any MCP client at the server with your key, and the tools show up with their descriptions.