groundhog.markets: free weather forecasts in one call, plus Kalshi and Polymarket market rules.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
The 7-day forecast of a place id from search: {id, title, text, url, metadata}. Keep the credits and link the url when you repeat numbers.
The 7-day forecast of a place id from search: {id, title, text, url, metadata}. Keep the credits and link the url when you repeat numbers.
| Argument | Type | Description |
|---|---|---|
| id* | string |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
}
},
"additionalProperties": false
}Daily high/low for any place from every free forecast: median, spread, rain, current obs and active alerts, with credits and the page URL. line ≈321 tok, week ≈566, table ≈1,567, series ≈1,564. Keep the credits and link the page when you repeat numbers. size=runs: one place, each source's newest runs by day with run_utc and fetched_at; NBM adds XND, P12, Q12. variable=rain: members' share of 0.01 in or more and heavier (n = model families), NBM calibrated, amounts by source, so far today, month to date; rain line ≈647 tok, table ≈1,955.
| Argument | Type | Description |
|---|---|---|
| all | boolean | table: also twin and stale rows |
| stn | string | rain: a settle station of the place, e.g. KORD |
| win | string | rain: lst = the climate day at a daily-rain settle station, cal = calendar day |
| date | string | today | tomorrow | +N (0-7) | YYYY-MM-DD, each place's local date. Default: today before 15:00 local, else tomorrow. |
| days | integer | week/table days (default 7) |
| runs | integer | size=runs: newest runs per source (1) |
| size | string | default line; runs = each source's newest runs by day (trading fields) |
| step | integer | series step hours (temp 3, rain 6) |
| hours | integer | series hours (72) |
| place* | any | Slug, name, 'City, ST', 'City, Country', ICAO or 'lat,lon'. An array (up to 10) for line/week. |
| units | string | default F in the US, else C; rain in inches with F, mm with C |
| format | string | line md, others tsv |
As-issued history for backtests (no look-ahead): kind=daily (every source's daily hi/lo/rain per run at a place), nbm (NBM text columns: TXN, XND, P12, Q12; view=day = the books' day view) or obs (settlement truth: CLI, routine-METAR max/min). from/to (<= 366 days, 1 unit per 31 days); run=ISO | lead=N (+cycle=H: the run issued N days before) | asof=ISO (what was known then). Rows carry fetched_at and origin (bf:* = backfilled). TSV by default.
| Argument | Type | Description |
|---|---|---|
| to | string | last target date (default from) |
| els | string | kind=nbm: elements, comma list (TXN,XND,P12,Q12,TMP) |
| run | string | one run, YYYY-MM-DDTHH:MMZ |
| stn | string | ICAO (kind=nbm, obs) |
| asof | string | newest run fetched by this UTC time (no look-ahead) |
| from* | string | first target date YYYY-MM-DD |
| kind | string | daily (default) | nbm | obs |
| lead | integer | the run issued N UTC days before each date |
Weather markets in a place (Kalshi, Polymarket high/low/rain): settlement station and rule, the number so far under that rule, our value and the official result once settled, forecast daily max/min at the station. No prices. Needs place or family. line ≈520 tok, table ≈1,757; every city ≈36,291. With neither: the list of market cities.
| Argument | Type | Description |
|---|---|---|
| date | string | today | tomorrow | yesterday | YYYY-MM-DD, each place's local date (default today) |
| size | string | line (default with place) | table (default without) |
| place | any | Slug, name, 'City, ST' or ICAO; an array for up to 10 places |
| family | string | high | low | rain | all (default all); alone: every market city |
| format | string | line md, table tsv |
| credits | string |
{
"type": "object",
"properties": {
"date": {
"type": "string",
"description": "today | tomorrow | yesterday | YYYY-MM-DD, each place's local date (default today)"
},
"size": {
"enum": [
"line",
"table"
],
"type": "string",
"description": "line (default with place) | table (default without)"
},
"place": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1
}
],
"description": "Slug, name, 'City, ST' or ICAO; an array for up to 10 places"
},
"family": {
"enum": [
"high",
"low",
"rain",
"all"
],
"type": "string",
"description": "high | low | rain | all (default all); alone: every market city"
},
"format": {
"enum": [
"md",
"tsv",
"json"
],
"type": "string",
"description": "line md, table tsv"
},
"credits": {
"enum": [
"compact",
"full",
"short"
],
"type": "string"
}
},
"additionalProperties": false
}Find a place slug by name, City, ST, airport code or lat,lon; says full blend or grid only.
| Argument | Type | Description |
|---|---|---|
| q* | string | |
| limit | integer |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 10,
"minimum": 1
}
},
"additionalProperties": false
}How often our settle value matched the venue's result, with every miss. No prices.
| Argument | Type | Description |
|---|---|---|
| days | integer | last N days (30) |
| venue | string | |
| family | string | |
| format | string | default tsv |
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "last N days (30)"
},
"venue": {
"enum": [
"kalshi",
"polymarket"
],
"type": "string"
},
"family": {
"enum": [
"high",
"low",
"rain",
"all"
],
"type": "string"
},
"format": {
"enum": [
"md",
"tsv",
"json"
],
"type": "string",
"description": "default tsv"
}
},
"additionalProperties": false
}Search places by name, City, ST, airport code or lat,lon. Returns {results: [{id, title, url, text}]}; pass an id to fetch.
| Argument | Type | Description |
|---|---|---|
| query* | string |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string"
}
},
"additionalProperties": false
}Open sources groundhog uses: licence, latest run, age, status.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}| credits |
| string |
| variable | string | temp (default) or rain |
| include_6h | boolean | temp only: also count 6-hourly (~) days |
{
"type": "object",
"required": [
"place"
],
"properties": {
"all": {
"type": "boolean",
"description": "table: also twin and stale rows"
},
"stn": {
"type": "string",
"description": "rain: a settle station of the place, e.g. KORD"
},
"win": {
"enum": [
"lst",
"cal"
],
"type": "string",
"description": "rain: lst = the climate day at a daily-rain settle station, cal = calendar day"
},
"date": {
"type": "string",
"description": "today | tomorrow | +N (0-7) | YYYY-MM-DD, each place's local date. Default: today before 15:00 local, else tomorrow."
},
"days": {
"type": "integer",
"maximum": 7,
"minimum": 1,
"description": "week/table days (default 7)"
},
"runs": {
"type": "integer",
"maximum": 4,
"minimum": 1,
"description": "size=runs: newest runs per source (1)"
},
"size": {
"enum": [
"line",
"week",
"table",
"series",
"runs"
],
"type": "string",
"description": "default line; runs = each source's newest runs by day (trading fields)"
},
"step": {
"enum": [
1,
3,
6
],
"type": "integer",
"description": "series step hours (temp 3, rain 6)"
},
"hours": {
"type": "integer",
"maximum": 168,
"minimum": 24,
"description": "series hours (72)"
},
"place": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
},
"maxItems": 10,
"minItems": 1
}
],
"description": "Slug, name, 'City, ST', 'City, Country', ICAO or 'lat,lon'. An array (up to 10) for line/week."
},
"units": {
"enum": [
"F",
"C"
],
"type": "string",
"description": "default F in the US, else C; rain in inches with F, mm with C"
},
"format": {
"enum": [
"md",
"tsv",
"json"
],
"type": "string",
"description": "line md, others tsv"
},
"credits": {
"enum": [
"compact",
"full",
"short"
],
"type": "string"
},
"variable": {
"enum": [
"temp",
"rain"
],
"type": "string",
"description": "temp (default) or rain"
},
"include_6h": {
"type": "boolean",
"description": "temp only: also count 6-hourly (~) days"
}
},
"additionalProperties": false
}| prod |
| string |
| kind=nbm: nbe (default) | nbs |
| view | string | kind=nbm: raw (default) | day |
| cycle | integer | with lead: only runs at H UTC |
| place | string | slug, name or ICAO (kind=daily; nbm/obs: its station) |
| format | string | tsv (default) | json |
| source | string | kind=daily: source ids, comma list (e.g. nbm,gfs,ifs) |
| product | string | kind=obs |
{
"type": "object",
"required": [
"from"
],
"properties": {
"to": {
"type": "string",
"description": "last target date (default from)"
},
"els": {
"type": "string",
"description": "kind=nbm: elements, comma list (TXN,XND,P12,Q12,TMP)"
},
"run": {
"type": "string",
"description": "one run, YYYY-MM-DDTHH:MMZ"
},
"stn": {
"type": "string",
"description": "ICAO (kind=nbm, obs)"
},
"asof": {
"type": "string",
"description": "newest run fetched by this UTC time (no look-ahead)"
},
"from": {
"type": "string",
"description": "first target date YYYY-MM-DD"
},
"kind": {
"enum": [
"daily",
"nbm",
"obs"
],
"type": "string",
"description": "daily (default) | nbm | obs"
},
"lead": {
"type": "integer",
"maximum": 15,
"minimum": 0,
"description": "the run issued N UTC days before each date"
},
"prod": {
"enum": [
"nbe",
"nbs"
],
"type": "string",
"description": "kind=nbm: nbe (default) | nbs"
},
"view": {
"enum": [
"raw",
"day"
],
"type": "string",
"description": "kind=nbm: raw (default) | day"
},
"cycle": {
"type": "integer",
"maximum": 23,
"minimum": 0,
"description": "with lead: only runs at H UTC"
},
"place": {
"type": "string",
"description": "slug, name or ICAO (kind=daily; nbm/obs: its station)"
},
"format": {
"enum": [
"tsv",
"json"
],
"type": "string",
"description": "tsv (default) | json"
},
"source": {
"type": "string",
"description": "kind=daily: source ids, comma list (e.g. nbm,gfs,ifs)"
},
"product": {
"enum": [
"CLI",
"METAR_R",
"ASOS"
],
"type": "string",
"description": "kind=obs"
}
},
"additionalProperties": false
}