GnistAI GnistAI
Log in

Open-Meteo (Weather)

Current weather, forecasts, historical data, and severe weather alerts.

Overview   |   MCP Docs   |   API Docs   |   OpenAPI   |   Playground   |   Tutorial   |   Toolkits   |   Home
status: healthy status status healthy healthy tools: 8 tools tools 8 8 Environment

Data source: Open-Meteo, NWS

MCP MCP Protocol

Endpoint https://context.gnist.ai/mcp/open-meteo/
claude_desktop_config.json
{
  "mcpServers": {
    "gnist-open-meteo": {
      "url": "https://context.gnist.ai/mcp/open-meteo/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}
Shell
curl -X POST "https://context.gnist.ai/mcp/open-meteo/" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "geocode_location", "arguments": {"name": "example"}}}'

API REST API

API Root https://context.gnist.ai/rest/open-meteo/

8 endpoints available:

Shell
curl "https://context.gnist.ai/rest/open-meteo/geocode_location?name=example" \
  -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx

resp = httpx.get(
    "https://context.gnist.ai/rest/open-meteo/geocode_location",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    params={
        "name": "example"
},
)
print(resp.json())

OpenAPI Spec  ·  Full API Docs

CLI Command Line

Command gc open-meteo

CLI documentation will be available when the GnistAI SDK is published.

Install
pip install gnistai

Available Tools (8)

geocode_location
Search for a city or place name and return matching coordinates.
ParameterTypeRequiredDescription
namestringrequiredCity or place name to search for (e.g. "Oslo", "New York", "Tokyo").
countintegeroptionalMaximum number of results to return (1-100). Default 5. (default: 5)
languagestringoptionalResponse language as ISO 639-1 code (e.g. 'en', 'de', 'fr'). Default 'en'. (default: "en")
get_current_weather
Get current weather conditions at a location.
ParameterTypeRequiredDescription
latnumberrequiredLatitude of the location (-90 to 90).
lonnumberrequiredLongitude of the location (-180 to 180).
unitsstringoptionalUnit system: "metric" (C, m/s, mm) or "imperial" (F, mph, inch). (default: "metric")
get_weather_forecast
Get hourly weather forecast for a location.
ParameterTypeRequiredDescription
latnumberrequiredLatitude of the location (-90 to 90).
lonnumberrequiredLongitude of the location (-180 to 180).
hoursintegeroptionalNumber of hours to forecast (1-168, default 24). (default: 24)
unitsstringoptionalUnit system: "metric" (C, m/s, mm) or "imperial" (F, mph, inch). (default: "metric")
get_alerts
Get active severe weather alerts for a location.
ParameterTypeRequiredDescription
latnumberrequiredLatitude of the location (-90 to 90).
lonnumberrequiredLongitude of the location (-180 to 180).
get_historical_weather
Get historical weather data for a location and date range.
ParameterTypeRequiredDescription
latnumberrequiredLatitude of the location (-90 to 90).
lonnumberrequiredLongitude of the location (-180 to 180).
start_datestringrequiredStart of the date range, format YYYY-MM-DD (earliest: 1940-01-01).
end_datestringrequiredEnd of the date range, format YYYY-MM-DD (latest: ~5 days ago).
unitsstringoptionalUnit system: "metric" (C, m/s, mm) or "imperial" (F, mph, inch). (default: "metric")
get_air_quality
Get air quality forecast for a location.
ParameterTypeRequiredDescription
latnumberrequiredLatitude of the location (-90 to 90).
lonnumberrequiredLongitude of the location (-180 to 180).
hoursintegeroptionalNumber of hours to forecast (1-120, default 24). (default: 24)
get_marine_forecast
Get marine/ocean forecast for a coastal location.
ParameterTypeRequiredDescription
latnumberrequiredLatitude of the coastal location (-90 to 90).
lonnumberrequiredLongitude of the coastal location (-180 to 180).
hoursintegeroptionalNumber of hours to forecast (1-168, default 24). (default: 24)
report_feedback
Report a bug, feature request, or general feedback for this data source.
ParameterTypeRequiredDescription
feedbackstringrequired
feedback_typestringoptional (default: "general")

Related