MCP Quickstart Weather Server
Adapts the MCP server to work with OpenAI's chat completions and responses API
Click on "Deploy 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 Server what'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)
Inputs: state (required).
get_forecastC
Get weather forecast for a location.
Args: latitude: Latitude of the location longitude: Longitude of the location
Inputs: latitude (required), longitude (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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
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.
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
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.-
- 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 gradedqualityDmaintenanceA 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.-