MCP Quickstart Weather Server
Adapts the MCP server to work with OpenAI's chat completions and responses API
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Quickstart Weather Serverwhat's the forecast for New York this weekend?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Learning Projects
Hands-on projects for understanding how to build applications using Model Context Protocol (MCP).
Projects
weather/ — MCP Server + Custom Client
A weather MCP server built from the official MCP Quickstart, extended with a custom Python MCP client that routes tool calls through the OpenAI Chat Completions and Responses APIs.
calculator/ — MCP Server with Resources and Interactive UI
A calculator MCP server that demonstrates MCP resources and MCP Apps — an extension that renders an interactive HTML calculator widget directly inside Claude Desktop.
chatkit/ — Chat Web App with MCP Backend
A full-stack chat application built on OpenAI ChatKit. The frontend is a React + Vite app; the backend is a FastAPI server that routes messages to MCP tool servers based on the selected composer mode.
Echo mode — echoes user input back verbatim
Weather mode — runs a LangChain agent backed by the
weather/MCP server; tool calls (get_alerts,get_forecast) are streamed live to the UI as a workflow with per-step status indicators
Requires Python 3.14+ for the backend.
Related MCP server: ambient-mcp
Requirements
Python 3.13+ and
uvNode.js 18+ and npm (for
chatkit/)Claude Desktop (for MCP Apps UI in the calculator project)
OpenAI API key (for the weather client and chatkit weather agent)
See each subfolder's README.md for setup and run instructions.
Available Tools
2 toolsget_alertsB
Get weather alerts for a US state.
Args: state: Two-letter US state code (e.g. CA, NY)
| Name | Required | Description | Default |
|---|---|---|---|
| state | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description must carry the behavioral disclosure burden, but it only restates the core purpose of retrieving alerts. It does not mention return format, data source, update frequency, or whether this is a safe read-only operation. This is a minimal behavioral statement rather than useful transparency.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is compact, front-loaded, and every sentence earns a place: the first line states the action, the second documents the only parameter. There is no filler or redundant information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with one simple parameter, the description is near-adequate. However, with no output schema and no annotations, it does not describe what the returned alerts contain or how to distinguish this tool from get_forecast when selecting. A small but real completion gap remains.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema only defines state as a string, so the description's 'Two-letter US state code (e.g. CA, NY)' adds important format and example context. It fully clarifies the sole parameter, though it does not enumerate all valid state codes or explain invalid input behavior.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with a specific verb and object ('Get weather alerts for a US state'), clearly identifying the tool's function. It does not explicitly contrast with sibling get_forecast, but the word 'alerts' already separates it from a forecast tool. Clear, but stops short of explicit sibling differentiation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to choose this tool over get_forecast or what conditions call for alerts versus forecast. The only usage-related content is the state parameter, which belongs more to parameter semantics. The agent receives no decision support for tool selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_forecastC
Get weather forecast for a location.
Args: latitude: Latitude of the location longitude: Longitude of the location
| Name | Required | Description | Default |
|---|---|---|---|
| latitude | Yes | ||
| longitude | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
There are no annotations, so the description bears the full burden of behavioral disclosure. It only says 'Get weather forecast' and gives no information about safety (read-only vs. side effects), units, time range, caching, or output structure. Such missing details matter for an external forecast API.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short and purpose-first, with a separate Args block for parameters. It is efficiently structured, though the Args section largely duplicates the input schema and could be trimmed without loss.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema and no annotations, the description should explain what forecast data is returned (e.g., temperature, precipitation, time horizon), coordinate constraints, and how this relates to the sibling get_alerts. It does none of these, so an agent lacks essential information for correct invocation and interpretation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description repeats the parameter names with minimal elaboration ('Latitude of the location'), which adds little beyond the input schema titles 'Latitude' and 'Longitude'. It does not specify units (e.g., decimal degrees), valid ranges, or coordinate format, so the parameter semantics are under-specified.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear verb and resource: 'Get weather forecast for a location.' This distinguishes it from the sibling tool get_alerts, which obviously deals with alerts rather than forecasts, even though it does not explicitly name the sibling.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided about when to use get_forecast versus get_alerts or any other alternative. The description gives no contextual hints about use cases, prerequisites, or exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
2 tool updates
v0.1.0- First observed
get_alerts - First observed
get_forecast
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: get_alerts retrieves alerts for a US state, while get_forecast provides forecasts for a specific latitude/longitude location. There is no overlap in functionality or ambiguity between them.
Both tools follow a consistent verb_noun naming pattern (get_alerts, get_forecast) with the same verb 'get' and descriptive nouns. The naming is predictable and uniform throughout the set.
With only 2 tools, the server feels thin for a weather domain. While it covers alerts and forecasts, it lacks other common weather operations like current conditions, historical data, or radar information, making the scope limited.
The tool surface is significantly incomplete for a weather server. It misses core functionalities such as getting current weather, historical data, or supporting broader geographic queries beyond US states or specific coordinates, which will limit agent effectiveness.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
An MCP server for weather information by @kulybaba
An MCP server for weather information by @kulybaba
Hosted MCP server for Xweather weather data: conditions, forecasts, alerts, and more.
Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server built with the mcp-framework to provide weather-related tools and data to AI clients. It enables integration of weather capabilities and custom tools into the MCP ecosystem for use with platforms like Claude Desktop.8-
- AlicenseNot gradedqualityDmaintenanceAn MCP server that wraps the Ambient Weather REST API. Query your personal weather stations conversationally from Claude Code, Claude.ai, or any MCP-compatible client.1MIT
- FlicenseNot gradedqualityDmaintenanceA simple MCP server that provides weather tools, deployable with Docker, and designed to be used with Claude Desktop via a WSL bridge.-
- FlicenseNot gradedqualityCmaintenanceA proof-of-concept MCP server that provides weather information using the Open-Meteo API, with tools for greeting, getting weather by coordinates, and by location name.-