Skip to main content
Glama
veysby

MCP Quickstart Weather Server

by veysby

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 uv

  • Node.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 tools
get_alertsB

Get weather alerts for a US state.

Args: state: Two-letter US state code (e.g. CA, NY)

ParametersJSON Schema
NameRequiredDescriptionDefault
stateYes

TDQS

B3.2/5.0
Behavior2/5

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.

Conciseness5/5

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.

Completeness3/5

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.

Parameters4/5

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.

Purpose4/5

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.

Usage Guidelines2/5

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

ParametersJSON Schema
NameRequiredDescriptionDefault
latitudeYes
longitudeYes

TDQS

C2.7/5.0
Behavior2/5

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.

Conciseness4/5

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.

Completeness2/5

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.

Parameters2/5

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.

Purpose4/5

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.

Usage Guidelines2/5

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.

  1. 2 tool updatesv0.1.0
    • First observedget_alerts
    • First observedget_forecast

TDQS

B3.1/5.0

Scored across 2 tools

Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count2/5

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.

Completeness2/5

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

ActivityInactive
ResponsivenessNo issues

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

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    A 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
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    An 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.
    1
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    A simple MCP server that provides weather tools, deployable with Docker, and designed to be used with Claude Desktop via a WSL bridge.
    -
  • F
    license
    Not graded
    quality
    C
    maintenance
    A 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.
    -