Overview
Use it as a weather data API for live conditions or as a weather forecast API for the week ahead. Query either a city name or a zip code to fetch real-time atmospheric readings. Responses supply temperature, wind speed, and compass heading in both metric and imperial measurements. Paid plans add a 7-day daily forecast with highs, lows, rain chance and precipitation totals, plus precipitation amounts, barometric pressure, apparent feels-like temperatures, visibility, and wind gust speeds.
Live Test Weather Skill Skill →
The tool
Once your client is connected to the VerveKit server, this appears in its tool list as WeatherSkill. It is read-only and open-world — it fetches and never mutates anything on your side — so most clients call it without asking you to confirm.
{
"name": "WeatherSkill",
"arguments": {
"city": "San Francisco"
}
}You do not name the tool yourself; the model picks it. Asking about San Francisco in the terms this skill covers is enough for it to reach for WeatherSkill on its own — naming it explicitly also works, and is the way to force the call.
Connecting
One server URL covers every skill in the catalog, including this one. Authorization is OAuth: the client opens a browser once, and there is no key to paste into a config file.
{
"mcpServers": {
"vervekit": {
"url": "https://api.vervekit.com/v1/mcp"
}
}
}https://api.vervekit.com/v1/mcpPer-client setup — Claude, Cursor, VS Code, ChatGPT — is on the MCP setup page.
Arguments
These are the properties on the tool's inputSchema, so a well-behaved client validates them before the call is made. Premium arguments are accepted on every plan but only take effect on plans that include them.
| Argument | Type | Description |
|---|---|---|
cityRequired | string | The city for which you want to get the current weather (e.g., San Francisco) |
forecastOptional | boolean | Included by default. Set to false to omit the 7-day forecast and return current conditions only. |
What the model gets back
The result carries a structuredContent object matching the tool's declared outputSchema, so a client reads fields without parsing prose. status is "ok" and error is null on success; a null field means the value was not available for that input, not that the call failed.
{
"status": "ok",
"error": null,
"data": {
"tempC": 13.3,
"tempF": 55.9,
"windMph": 4.7,
"windKph": 7.6,
"windDegree": 273,
"windDir": "W",
"pressureMb": 1022,
"pressureIn": 30.17,
"precipMm": 0,
"precipIn": 0,
"feelslikeC": 13,
"feelslikeF": 55.3,
"visKm": 16,
"visMiles": 9,
"gustMph": 7.2,
"gustKph": 11.6,
"forecast": [
{
"date": "2026-09-21",
"condition": "Sunny",
"maxtempC": 22.5,
"maxtempF": 72.5,
"mintempC": 13.3,
"mintempF": 56,
"avgtempC": 17.7,
"avgtempF": 63.9,
"maxwindMph": 4.7,
"maxwindKph": 7.6,
"avghumidity": 48,
"uv": 4,
"willItRain": 0,
"chanceOfRain": 4,
"willItSnow": 0,
"chanceOfSnow": 0,
"totalprecipMm": 0,
"totalprecipIn": 0,
"totalsnowCm": 0,
"avgvisKm": 10,
"avgvisMiles": 6
},
{
"date": "2026-09-22",
"condition": "Sunny",
"maxtempC": 22.8,
"maxtempF": 73,
"mintempC": 16.5,
"mintempF": 61.7,
"avgtempC": 19.7,
"avgtempF": 67.5,
"maxwindMph": 4.7,
"maxwindKph": 7.6,
"avghumidity": 63,
"uv": 3.9,
"willItRain": 0,
"chanceOfRain": 8,
"willItSnow": 0,
"chanceOfSnow": 0,
"totalprecipMm": 0.02,
"totalprecipIn": 0,
"totalsnowCm": 0,
"avgvisKm": 10,
"avgvisMiles": 6
},
{
"date": "2026-09-23",
"condition": "Overcast",
"maxtempC": 22.8,
"maxtempF": 73.1,
"mintempC": 14.1,
"mintempF": 57.4,
"avgtempC": 18.4,
"avgtempF": 65.2,
"maxwindMph": 15.7,
"maxwindKph": 25.2,
"avghumidity": 70,
"uv": 3.1,
"willItRain": 1,
"chanceOfRain": 76,
"willItSnow": 0,
"chanceOfSnow": 0,
"totalprecipMm": 5.97,
"totalprecipIn": 0.23,
"totalsnowCm": 0,
"avgvisKm": 9.9,
"avgvisMiles": 6
},
{
"date": "2026-09-24",
"condition": "Partly Cloudy",
"maxtempC": 18,
"maxtempF": 64.5,
"mintempC": 10.5,
"mintempF": 50.8,
"avgtempC": 14.3,
"avgtempF": 57.7,
"maxwindMph": 11,
"maxwindKph": 17.6,
"avghumidity": 64,
"uv": 3.5,
"willItRain": 0,
"chanceOfRain": 11,
"willItSnow": 0,
"chanceOfSnow": 0,
"totalprecipMm": 0.03,
"totalprecipIn": 0,
"totalsnowCm": 0,
"avgvisKm": 10,
"avgvisMiles": 6
},
{
"date": "2026-09-25",
"condition": "Sunny",
"maxtempC": 21.3,
"maxtempF": 70.3,
"mintempC": 12,
"mintempF": 53.6,
"avgtempC": 16,
"avgtempF": 60.8,
"maxwindMph": 6.5,
"maxwindKph": 10.4,
"avghumidity": 56,
"uv": 6,
"willItRain": 0,
"chanceOfRain": 4,
"willItSnow": 0,
"chanceOfSnow": 0,
"totalprecipMm": 0,
"totalprecipIn": 0,
"totalsnowCm": 0,
"avgvisKm": 10,
"avgvisMiles": 6
},
{
"date": "2026-09-26",
"condition": "Sunny",
"maxtempC": 22,
"maxtempF": 71.5,
"mintempC": 13,
"mintempF": 55.3,
"avgtempC": 17.1,
"avgtempF": 62.8,
"maxwindMph": 8.9,
"maxwindKph": 14.4,
"avghumidity": 62,
"uv": 6,
"willItRain": 0,
"chanceOfRain": 8,
"willItSnow": 0,
"chanceOfSnow": 0,
"totalprecipMm": 0,
"totalprecipIn": 0,
"totalsnowCm": 0,
"avgvisKm": 10,
"avgvisMiles": 6
},
{
"date": "2026-09-27",
"condition": "Overcast",
"maxtempC": 19.3,
"maxtempF": 66.8,
"mintempC": 12.8,
"mintempF": 55.1,
"avgtempC": 16.3,
"avgtempF": 61.3,
"maxwindMph": 6.9,
"maxwindKph": 11.2,
"avghumidity": 67,
"uv": 4,
"willItRain": 0,
"chanceOfRain": 36,
"willItSnow": 0,
"chanceOfSnow": 0,
"totalprecipMm": 0.32,
"totalprecipIn": 0.01,
"totalsnowCm": 0,
"avgvisKm": 10,
"avgvisMiles": 6
}
],
"forecastSummary": {
"rainExpectedOn": "2026-09-23",
"daysWithRain": 1,
"tempTrend": "cooling",
"tempTrendC": -2.1,
"maxChanceOfRain": 76
}
}
}
Response fields
Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.
| Field | Type | Example | Description |
|---|---|---|---|
tempC | number | 13.3 | Current temperature in degrees Celsius |
tempF | number | 55.9 | Current temperature in degrees Fahrenheit |
windMph | number | 4.7 | Wind speed in miles per hour |
windKph | number | 7.6 | Wind speed in kilometers per hour |
windDegree | number | 273 | Wind direction in degrees (0-360) |
windDir | string | W | Wind direction as compass point (N, S, E, W, etc.) |
pressureMbPremium | number | 1022 | Atmospheric pressure in millibars |
pressureInPremium | number | 30.17 | Atmospheric pressure in inches of mercury |
precipMmPremium | number | 0 | Precipitation amount in millimeters |
precipInPremium | number | 0 | Precipitation amount in inches |
feelslikeCPremium | number | 13 | Apparent temperature in degrees Celsius |
feelslikeFPremium | number | 55.3 | Apparent temperature in degrees Fahrenheit |
visKmPremium | number | 16 | Visibility distance in kilometers |
visMilesPremium | number | 9 | Visibility distance in miles |
gustMphPremium | number | 7.2 | Wind gust speed in miles per hour |
gustKphPremium | number | 11.6 | Wind gust speed in kilometers per hour |
forecastPremium | array[7] | A 7-day daily forecast for the location, one entry per day, starting today | |
forecast.0.datePremium | string | 2026-09-21 | Forecast date in YYYY-MM-DD |
forecast.0.conditionPremium | string | Sunny | Summary weather condition for the day (e.g., Sunny, Overcast) |
forecast.0.maxtempCPremium | number | 22.5 | Highest temperature for the day in degrees Celsius |
forecast.0.maxtempFPremium | number | 72.5 | Highest temperature for the day in degrees Fahrenheit |
forecast.0.mintempCPremium | number | 13.3 | Lowest temperature for the day in degrees Celsius |
forecast.0.mintempFPremium | number | 56 | Lowest temperature for the day in degrees Fahrenheit |
forecast.0.avgtempCPremium | number | 17.7 | Average temperature for the day in degrees Celsius |
forecast.0.avgtempFPremium | number | 63.9 | Average temperature for the day in degrees Fahrenheit |
forecast.0.maxwindMphPremium | number | 4.7 | Maximum sustained wind speed for the day in miles per hour |
forecast.0.maxwindKphPremium | number | 7.6 | Maximum sustained wind speed for the day in kilometers per hour |
forecast.0.avghumidityPremium | number | 48 | Average relative humidity for the day as a percentage |
forecast.0.uvPremium | number | 4 | Maximum UV index for the day |
forecast.0.willItRainPremium | number | 0 | 1 if rain is expected during the day, 0 if not |
forecast.0.chanceOfRainPremium | number | 4 | Probability of rain during the day as a percentage |
forecast.0.willItSnowPremium | number | 0 | 1 if snow is expected during the day, 0 if not |
forecast.0.chanceOfSnowPremium | number | 0 | Probability of snow during the day as a percentage |
forecast.0.totalprecipMmPremium | number | 0 | Total precipitation for the day in millimeters |
forecast.0.totalprecipInPremium | number | 0 | Total precipitation for the day in inches |
forecast.0.totalsnowCmPremium | number | 0 | Total snowfall for the day in centimeters |
forecast.0.avgvisKmPremium | number | 10 | Average visibility for the day in kilometers |
forecast.0.avgvisMilesPremium | number | 6 | Average visibility for the day in miles |
forecastSummaryPremium | object | {…} | Derived read of the whole forecast window — when rain is expected and which way the temperature is trending |
forecastSummary.rainExpectedOnPremium | string | 2026-09-23 | Date of the first day at or above a 50 percent chance of rain, or null if none |
forecastSummary.daysWithRainPremium | number | 1 | Number of days in the window at or above a 50 percent chance of rain |
forecastSummary.tempTrendPremium | string | cooling | Direction of travel across the window: warming, cooling, or steady |
forecastSummary.tempTrendCPremium | number | -2.1 | Change in average temperature across the window in degrees Celsius |
forecastSummary.maxChanceOfRainPremium | number | 76 | Highest daily chance of rain across the window as a percentage |
Failure modes
Errors come back as tool errors carrying a sentence the model can act on, not a bare status code. Error handling covers the full list.
| Status | What it means |
|---|---|
400 / 422 | The arguments did not validate. The message names the offending one. |
401 | The OAuth session is invalid or expired — reconnect the server. |
403 | Blocked by a key restriction or an IP allow-list. Never a bad identity. |
404 | This skill is not part of VerveKit. Check the catalog. |
429 | Out of credits, or a brief rate limit. The message tells them apart. |
A call costs 10 credits each time the tool actually runs; a model that reasons about the tool without calling it costs nothing.
Use cases
- Delivery Route Planning
- When high winds threaten courier safety, dispatch software checks live wind speeds and compass direction across delivery zones before assigning routes, and reads the coming week of forecasts to reschedule ahead of bad days.
- Travel Booking Portals
- Travel sites display real-time temperatures for destination cities alongside a 7-day outlook so travelers know what conditions to expect across their whole stay.
- Smart Home Thermostats
- Home automation platforms read outdoor temperatures for local zip codes to adjust heating and cooling cycles throughout the day.
- Outdoor Event Management
- Organizers monitor current wind speeds and temperatures by city to decide when to secure temporary staging, and use daily rain chance to pick a date or trigger a postponement early.
- Field Service Scheduling
- Dispatchers check daily rain chance and precipitation totals for the week ahead to slot outdoor jobs like roofing or landscaping onto dry days.
Other ways to use Weather Skill
Set up Weather Skill on VerveKit, or reach the same source a different way. Your VerveKit account and credits work on all of them — one key, one balance.
Related
Pages that use this skill:
- GraphQLPlatform
More in Weather: