[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_115":116},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module '@cyanheads/open-meteo-mcp-server' is not configured","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":26,"_34":-5,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":48,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":-5,"_63":-5,"_64":65,"_66":67,"_68":69,"_70":71,"_72":73,"_74":-5,"_75":-5,"_76":-5,"_77":48,"_78":-5,"_79":80,"_81":82,"_83":84,"_85":86,"_87":88,"_89":90,"_91":92},"apiUrl","https://odel.app/api","creator","cyanheads","moduleId","open-meteo-mcp-server","@cyanheads/open-meteo-mcp-server","displayName","open meteo mcp server","tagline","Global weather via Open-Meteo: forecast, ERA5 archive, marine, air quality, geocoding, elevation.","iconKey","https://avatars.githubusercontent.com/u/10339515?v=4","category","dev-tools","status","published","metaDescription","metaKeywords","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://open-meteo.caseyjhand.com/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1781363414000,"updatedAt",1781499612000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.cyanheads%2Fopen-meteo-mcp-server","sourceVerified",true,"importedAt","upstreamStars",2,"upstreamUpdatedAt",1781322394000,"detectedTransport","detectedAuthType","probeStatus","lastProbedAt","githubRepoUrl","https://github.com/cyanheads/open-meteo-mcp-server","githubRepoFullName","cyanheads/open-meteo-mcp-server","releaseId","ext-cyanheads-open-meteo-mcp-server","version","0.1.5","descriptionMarkdown","

@cyanheads/open-meteo-mcp-server

Geocode places, fetch global weather forecasts, ERA5 historical climate, marine conditions, air quality, and terrain elevation via MCP. STDIO or Streamable HTTP.\n

10 Tools

\n\n

\n\n[![Version](https://img.shields.io/badge/Version-0.1.5-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/open-meteo-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/open-meteo-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/open-meteo-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.0-blueviolet.svg?style=flat-square)](https://bun.sh/)\n\n

\n\n

\n\n[![Install in Claude Desktop](https://img.shields.io/badge/Install_in-Claude_Desktop-D97757?style=for-the-badge&logo=anthropic&logoColor=white)](https://github.com/cyanheads/open-meteo-mcp-server/releases/latest/download/open-meteo-mcp-server.mcpb) [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=open-meteo-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjeWFuaGVhZHMvb3Blbi1tZXRlby1tY3Atc2VydmVyIl19) [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22open-meteo-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40cyanheads%2Fopen-meteo-mcp-server%22%5D%7D)\n\n[![Framework](https://img.shields.io/badge/Built%20on-@cyanheads/mcp--ts--core-67E8F9?style=flat-square)](https://www.npmjs.com/package/@cyanheads/mcp-ts-core)\n\n

\n\n

\n\n**Public Hosted Server:** [https://open-meteo.caseyjhand.com/mcp](https://open-meteo.caseyjhand.com/mcp)\n\n

\n\n---\n\n## Tools\n\nTen tools covering geocoding, weather forecasts, historical climate, probabilistic ensemble forecasts, marine conditions, air quality, terrain elevation, river discharge, and SQL analytics over large datasets:\n\n| Tool | Description |\n|:---|:---|\n| `openmeteo_geocode` | Resolve a place name to ranked coordinate matches with country, region, elevation, timezone, and population |\n| `openmeteo_get_forecast` | Weather forecast for coordinates: hourly and/or daily variables for up to 16 days, with optional recent past data |\n| `openmeteo_get_historical` | Historical weather from the ERA5 reanalysis archive (1940–present); large ranges spill to DataCanvas |\n| `openmeteo_get_marine` | Marine forecast for coastal or ocean coordinates: wave height, period, direction, swell, and sea-surface temperature |\n| `openmeteo_get_air_quality` | Modeled CAMS air quality forecast: PM2.5, PM10, NO2, O3, CO, dust, pollen, and European/US AQI indices |\n| `openmeteo_get_elevation` | Terrain elevation from Copernicus DEM (~90m resolution) for up to 100 coordinate pairs per call |\n| `openmeteo_get_ensemble` | Probabilistic ensemble forecast: per-member hourly/daily time series (up to 51 members, 16 days) for exceedance and uncertainty analysis |\n| `openmeteo_get_flood` | GloFAS river discharge forecast (up to 210 days) and reanalysis (1984–present); coordinate-based, snaps to nearest river |\n| `openmeteo_dataframe_describe` | List tables and columns on a DataCanvas staged by `openmeteo_get_historical` or `openmeteo_get_ensemble` |\n| `openmeteo_dataframe_query` | Run a read-only SQL SELECT against tables staged on a DataCanvas |\n\n### `openmeteo_geocode`\n\nResolve a free-text place name to ranked coordinate matches. Required first step for name-based queries — all weather tools accept latitude/longitude, not place names.\n\n- Returns name, country, admin1/admin2, latitude, longitude, elevation, IANA timezone, population, and GeoNames feature code\n- Up to 10 ranked matches (default 5), most relevant first — use `count` for disambiguation when common names (e.g., \"Springfield\") may match multiple cities\n- Pass the timezone from a geocode result directly to weather tools as the `timezone` parameter\n- Returns an empty `results` array (not an error) when no places match\n\n---\n\n### `openmeteo_get_forecast`\n\nWeather forecast for a coordinate pair with hourly and/or daily variable selection.\n\n- Up to 16 forecast days ahead (`forecast_days 1–16`, default 7)\n- `past_days` (0–92) covers recent history via the forecast model — use instead of `openmeteo_get_historical` for dates within the last ~5 days to avoid ERA5 lag\n- Common hourly variables: `temperature_2m`, `precipitation`, `wind_speed_10m`, `relative_humidity_2m`, `cloud_cover`, `uv_index`, `apparent_temperature`, `precipitation_probability`, `weather_code`, `surface_pressure`, `visibility`, `wind_direction_10m`, `wind_gusts_10m`, `dew_point_2m`\n- Common daily variables: `temperature_2m_max`, `temperature_2m_min`, `precipitation_sum`, `wind_speed_10m_max`, `sunrise`, `sunset`, `uv_index_max`, `precipitation_hours`, `weather_code`\n- At least one of `hourly_variables` or `daily_variables` is required\n- Configurable temperature unit (Celsius/Fahrenheit), wind speed unit (km/h, mph, m/s, knots), and precipitation unit (mm/inch)\n- Reshapes the API's columnar response into per-timestamp records with a parallel `hourly_units` / `daily_units` map\n\n---\n\n### `openmeteo_get_historical`\n\nHistorical weather from the ERA5 reanalysis archive, covering 1940 to approximately 5 days ago.\n\n- Requires `start_date` and `end_date` (YYYY-MM-DD); ERA5 has a variable ~1–5 day lag\n- Same variable vocabulary as `openmeteo_get_forecast` — past and forecast data are directly comparable on one schema\n- At least one of `hourly_variables` or `daily_variables` is required\n- Large date ranges (multi-year hourly queries) spill to DataCanvas when `CANVAS_PROVIDER_TYPE=duckdb` — output includes `canvas_id` and `truncated: true` when the inline record limit is exceeded\n- Spill → query workflow: call `openmeteo_dataframe_describe` with the `canvas_id` to list tables, then `openmeteo_dataframe_query` to run SQL SELECT against the staged data\n\n---\n\n### `openmeteo_get_marine`\n\nMarine weather forecast for coastal and open-ocean coordinates.\n\n- Up to 7 forecast days (`forecast_days 1–7`, default 7)\n- Common hourly variables: `wave_height`, `wave_direction`, `wave_period`, `wind_wave_height`, `wind_wave_direction`, `wind_wave_period`, `swell_wave_height`, `swell_wave_direction`, `swell_wave_period`\n- Common daily variables: `wave_height_max`, `wave_direction_dominant`, `wave_period_max`\n- At least one of `hourly_variables` or `daily_variables` is required\n- Inland or sheltered-water points return near-zero wave values (physically correct); `ocean_current_velocity` is null for non-open-ocean coordinates\n\n---\n\n### `openmeteo_get_air_quality`\n\nModeled CAMS air quality forecast. Forecast-only — there is no historical archive for CAMS data.\n\n- Up to 7 forecast days (`forecast_days 1–7`, default 5)\n- Common variables: `pm2_5`, `pm10`, `carbon_monoxide`, `nitrogen_dioxide`, `sulphur_dioxide`, `ozone`, `dust`, `european_aqi`, `us_aqi`, `alder_pollen`, `birch_pollen`, `grass_pollen`, `mugwort_pollen`, `olive_pollen`, `ragweed_pollen`\n- At least one variable from `hourly_variables` is required\n- Grid-modeled data from CAMS — resolution is coarser than ground stations; for measured station readings, cross-reference `openaq-mcp-server`\n- Output includes `data_source: \"CAMS\"` to distinguish modeled from measured data\n\n---\n\n### `openmeteo_get_elevation`\n\nTerrain elevation from the Copernicus Digital Elevation Model (~90m resolution).\n\n- Accepts parallel `latitudes[]` and `longitudes[]` arrays; both must have equal length (up to 100 pairs)\n- Returns results in input order: `{ latitude, longitude, elevation_m }`\n- Useful for geographic context, elevation-adjusted weather interpretation, or route planning\n\n---\n\n### `openmeteo_get_ensemble`\n\nProbabilistic ensemble weather forecast exposing all individual model member trajectories.\n\n- Up to 16 forecast days (`forecast_days 1–16`, default 7) with optional `past_days` (0–92)\n- Each requested variable is returned as per-member columns: `temperature_2m_member01`, `temperature_2m_member02`, … Use the spread across members to compute exceedance probabilities, interquantile ranges, and decision thresholds\n- Available ensemble models: `ecmwf_ifs025` (51 members, global 0.25°), `gfs025` (31 members), `icon_seamless` (40 members, global/Europe blend), `gem_global` (21 members). Omit `models` to use the API default\n- Response includes `model` (system used) and `member_count` (number of members)\n- At least one of `hourly_variables` or `daily_variables` is required\n- Large multi-member, multi-day pulls spill to DataCanvas when `CANVAS_PROVIDER_TYPE=duckdb` — output includes `canvas_id` and `truncated: true`; query with `openmeteo_dataframe_query`\n- Configurable temperature, wind speed, and precipitation units\n\n---\n\n### `openmeteo_get_flood`\n\nGloFAS (Global Flood Awareness System) river discharge forecast and reanalysis via the Open-Meteo Flood API.\n\n- Coordinate-based — no river ID needed; the API snaps to the nearest river grid point automatically\n- Forecast horizon up to 210 days; reanalysis history from 1984-01-01 to present\n- Use `forecast_days` for future outlook, `start_date`/`end_date` for historical analysis; both can be combined\n- Available daily variables: `river_discharge` (ensemble mean), `river_discharge_mean`, `river_discharge_min`, `river_discharge_max`, `river_discharge_median`, `river_discharge_p25` (25th percentile), `river_discharge_p75` (75th percentile) — all in m³/s\n- Returns null for coordinates outside GloFAS coverage (e.g., open ocean or areas without river network data)\n- Discharge values reflect the GloFAS ensemble — percentile variables expose the uncertainty spread\n\n## Features\n\nBuilt on [`@cyanheads/mcp-ts-core`](https://github.com/cyanheads/mcp-ts-core):\n\n- Declarative tool definitions — single file per tool, framework handles registration and validation\n- Unified error handling — handlers throw, framework catches, classifies, and formats\n- Pluggable auth: `none`, `jwt`, `oauth`\n- Swappable storage backends: `in-memory`, `filesystem`, `Supabase`, `Cloudflare KV/R2/D1`\n- Structured logging with optional OpenTelemetry tracing\n- STDIO and Streamable HTTP transports\n\nOpen-Meteo–specific:\n\n- No API key required for non-commercial use — zero-config out of the box\n- Self-contained geocoding: `openmeteo_geocode` resolves place names so agents don't need a separate geocoder\n- ERA5 archive from 1940 to present with same variable schema as the forecast API — direct past/forecast comparisons on one schema\n- Automatic columnar-to-record reshape: Open-Meteo returns parallel time/variable arrays; handlers convert to per-timestamp records with a `*_units` map\n- DataCanvas spillover for `openmeteo_get_historical` and `openmeteo_get_ensemble`: large queries that exceed the inline record limit register a DuckDB dataframe for SQL querying\n- Configurable base URLs for all seven API endpoints (forecast, archive, marine, air quality, geocoding, ensemble, flood) — override for testing or self-hosted deployments\n- **Attribution:** Weather data by [Open-Meteo.com](https://open-meteo.com/) (CC BY 4.0). Non-commercial use is free and keyless; commercial use requires Open-Meteo's paid API tier (~10,000 req/day, 5,000/hour fair-use ceiling for non-commercial)\n\nAgent-friendly output:\n\n- Geocode-first workflow: `openmeteo_geocode` returns the IANA timezone alongside coordinates — pass it directly as `timezone` to any weather tool\n- Recovery hints on all error contracts — invalid variable names surface correction guidance with common variable examples\n- Coordinate snapping transparency — responses echo the snapped `latitude`/`longitude` (Open-Meteo quantizes to the nearest model grid point) so agents can reason about grid alignment\n- `data_source: \"CAMS\"` label on air quality results distinguishes modeled forecast data from measured station readings\n\n## Getting started\n\n### Public Hosted Instance\n\nA public instance is available at `https://open-meteo.caseyjhand.com/mcp` — no installation required. Point any MCP client at it via Streamable HTTP:\n\n```json\n{\n \"mcpServers\": {\n \"open-meteo-mcp-server\": {\n \"type\": \"streamable-http\",\n \"url\": \"https://open-meteo.caseyjhand.com/mcp\"\n }\n }\n}\n```\n\n### Self-Hosted / Local\n\nAdd the following to your MCP client configuration file.\n\n```json\n{\n \"mcpServers\": {\n \"open-meteo-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"bunx\",\n \"args\": [\"@cyanheads/open-meteo-mcp-server@latest\"],\n \"env\": {\n \"MCP_TRANSPORT_TYPE\": \"stdio\",\n \"MCP_LOG_LEVEL\": \"info\"\n }\n }\n }\n}\n```\n\nOr with npx (no Bun required):\n\n```json\n{\n \"mcpServers\": {\n \"open-meteo-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@cyanheads/open-meteo-mcp-server@latest\"],\n \"env\": {\n \"MCP_TRANSPORT_TYPE\": \"stdio\",\n \"MCP_LOG_LEVEL\": \"info\"\n }\n }\n }\n}\n```\n\nOr with Docker:\n\n```json\n{\n \"mcpServers\": {\n \"open-meteo-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"docker\",\n \"args\": [\"run\", \"-i\", \"--rm\", \"-e\", \"MCP_TRANSPORT_TYPE=stdio\", \"ghcr.io/cyanheads/open-meteo-mcp-server:latest\"]\n }\n }\n}\n```\n\nFor Streamable HTTP, set the transport and start the server:\n\n```sh\nMCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 bun run start:http\n# Server listens at http://localhost:3010/mcp\n```\n\n### Prerequisites\n\n- [Bun v1.3.0](https://bun.sh/) or higher (or Node.js v24+).\n- No API key required. Non-commercial use is free and keyless.\n- Commercial use requires [Open-Meteo's paid API tier](https://open-meteo.com/en/pricing).\n\n### Installation\n\n1. **Clone the repository:**\n\n```sh\ngit clone https://github.com/cyanheads/open-meteo-mcp-server.git\n```\n\n2. **Navigate into the directory:**\n\n```sh\ncd open-meteo-mcp-server\n```\n\n3. **Install dependencies:**\n\n```sh\nbun install\n```\n\n## Configuration\n\nAll configuration is validated at startup via Zod schemas. No API key is required for non-commercial use — all variables are optional.\n\n| Variable | Description | Default |\n|:---|:---|:---|\n| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http` | `stdio` |\n| `MCP_HTTP_PORT` | HTTP server port | `3010` |\n| `MCP_HTTP_ENDPOINT_PATH` | HTTP endpoint path | `/mcp` |\n| `MCP_PUBLIC_URL` | Public origin for TLS-terminating reverse-proxy deployments | — |\n| `MCP_AUTH_MODE` | Auth mode: `none`, `jwt`, or `oauth` | `none` |\n| `MCP_LOG_LEVEL` | Log level (`debug`, `info`, `warning`, `error`) | `info` |\n| `MCP_GC_PRESSURE_INTERVAL_MS` | Opt-in forced-GC interval (ms, Bun only). Set to `60000` if heap growth is observed under sustained HTTP traffic. | `0` |\n| `LOGS_DIR` | Directory for log files (Node.js only) | `/logs` |\n| `STORAGE_PROVIDER_TYPE` | Storage backend: `in-memory`, `filesystem`, `supabase`, `cloudflare-kv/r2/d1` | `in-memory` |\n| `CANVAS_PROVIDER_TYPE` | Canvas engine for `openmeteo_get_historical` spillover: `duckdb` or `none` | `none` |\n| `OPEN_METEO_API_BASE_URL` | Override for the main forecast + elevation API | `https://api.open-meteo.com` |\n| `OPEN_METEO_ARCHIVE_BASE_URL` | Override for the ERA5 historical archive API | `https://archive-api.open-meteo.com` |\n| `OPEN_METEO_MARINE_BASE_URL` | Override for the marine forecast API | `https://marine-api.open-meteo.com` |\n| `OPEN_METEO_AIR_QUALITY_BASE_URL` | Override for the CAMS air quality API | `https://air-quality-api.open-meteo.com` |\n| `OPEN_METEO_GEOCODING_BASE_URL` | Override for the geocoding API | `https://geocoding-api.open-meteo.com` |\n| `OTEL_ENABLED` | Enable OpenTelemetry tracing and metrics | `false` |\n\nSee [`.env.example`](https://github.com/cyanheads/open-meteo-mcp-server/blob/main/.env.example) for the full list of optional overrides.\n\n## Running the server\n\n### Local development\n\n- **Build and run the production version:**\n\n ```sh\n # One-time build\n bun run rebuild\n\n # Run the built server\n bun run start:http\n # or\n bun run start:stdio\n ```\n\n- **Run checks and tests:**\n\n ```sh\n bun run devcheck # Lint, format, typecheck, security\n bun run test # Vitest test suite\n ```\n\n### Docker\n\n```sh\ndocker build -t open-meteo-mcp-server .\ndocker run --rm -p 3010:3010 open-meteo-mcp-server\n```\n\nThe Dockerfile defaults to HTTP transport, stateless session mode, and logs to `/var/log/open-meteo-mcp-server`. OpenTelemetry peer dependencies are installed by default — build with `--build-arg OTEL_ENABLED=false` to omit them.\n\n## Project structure\n\n| Directory | Purpose |\n|:---|:---|\n| `src/index.ts` | `createApp()` entry point — registers tools, initializes the Open-Meteo service |\n| `src/config` | Server-specific environment variable parsing and validation with Zod |\n| `src/mcp-server/tools/definitions` | Tool definitions (`*.tool.ts`) — one file per tool; includes `dataframe-describe.tool.ts` and `dataframe-query.tool.ts` |\n| `src/services/open-meteo` | Open-Meteo HTTP client wrapping all six endpoints with retry, error classification, and columnar reshape |\n| `src/services/canvas-accessor.ts` | DataCanvas accessor for `openmeteo_get_historical` spillover |\n| `tests/` | Unit and integration tests mirroring `src/` |\n\n## Development guide\n\nSee [`CLAUDE.md`](https://github.com/cyanheads/open-meteo-mcp-server/blob/main/CLAUDE.md) for development guidelines and architectural rules. The short version:\n\n- Handlers throw, framework catches — no `try/catch` in tool logic\n- Use `ctx.log` for request-scoped logging, `ctx.state` for tenant-scoped storage\n- Register new tools in the `tools[]` array in `src/index.ts`\n- Wrap external API calls: validate raw → normalize to domain type → return output schema; never fabricate missing fields\n\n## Contributing\n\nIssues and pull requests are welcome. Run checks and tests before submitting:\n\n```sh\nbun run devcheck\nbun run test\n```\n\n## License\n\nApache-2.0 — see [LICENSE](https://github.com/cyanheads/open-meteo-mcp-server/blob/main/LICENSE) for details.\n\n---\n\n> Weather data by [Open-Meteo.com](https://open-meteo.com/) — licensed [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"categoryDisplayName","Developer Tools","upstream",{"_95":96,"_97":98,"_99":100,"_101":102,"_103":104},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_93":80,"_94":80},"ratingAvg","reviewCount","topics",[105,106,107,19,108,109,110,111,112,113,114],"license","Apache-2.0","language","TypeScript","registryName","io.github.cyanheads/open-meteo-mcp-server","homepage","https://www.npmjs.com/package/@cyanheads/open-meteo-mcp-server","ai-agents","ai-tools","climate","forecast","mcp","mcp-server","model-context-protocol","open-meteo","typescript","weather","ENV",{"_117":118,"_119":120,"_121":122},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]