Ambient Weather MCP Server

@NanaGyamfiPrempeh30

Basic information

About Ambient Weather MCP Server

An MCP server that connects AI assistants to Ambient Weather personal weather stations. Built with Python FastMCP. Exposes three tools: ping (health check), get_devices (lists all stations on your account with latest readings), and get_current_weather (full weather report for a s

#weather #iot #home-automation #api-integration #python #docker #stdio

Ambient Weather MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "ambient-weather": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AMBIENT_API_KEY",
        "-e",
        "AMBIENT_APP_KEY",
        "yawgyamfiprem32/ambient-weather-mcp:latest"
      ],
      "env": {
        "AMBIENT_API_KEY": "<YOUR_API_KEY>",
        "AMBIENT_APP_KEY": "<YOUR_APP_KEY>"
      }
    }
  }
}

Ambient Weather MCP Server tools

health check confirming the server is running and keys are configured

lists all weather stations on your account with their latest readings

full weather report for a specific station, by MAC address

Overview

What is Ambient Weather MCP?

Ambient Weather MCP is a Model Context Protocol server that connects AI assistants to personal Ambient Weather stations. It allows users to ask natural‑language questions about their weather data instead of parsing raw API JSON.

How to use Ambient Weather MCP?

Run the server via Docker with your Ambient API Key and Application Key set as environment variables: docker run -i --rm -e AMBIENT_API_KEY="..." -e AMBIENT_APP_KEY="..." yawgyamfiprem32/ambient-weather-mcp:latest. The -i flag is required because stdio MCP servers exit immediately on EOF without it. After startup, three tools are available: ping, get_devices, and get_current_weather.

Key features of Ambient Weather MCP

Health‑check endpoint (ping) to confirm server and key configuration
List all stations on your account with latest readings (get_devices)
Retrieve full weather report for a specific station by MAC address (get_current_weather)
Runs as a non‑root user with no embedded secrets
Credentials provided only via environment variables and never logged
TruffleHog scans every commit and push for security

Use cases of Ambient Weather MCP

Query your personal weather station’s current conditions using natural language
Check the health and configuration of the MCP server
List all registered stations and their latest sensor data in one call
Integrate real‑time weather readings into an AI‑powered assistant or chat interface

Frequently asked questions

What API keys do I need?

You need an Application Key and an API Key, both generated from your account at dashboard.ambientweather.net/account.

How do I run the server?

Use the Docker command with the required environment variables (`AMBIENT_API_KEY` and `AMBIENT_APP_KEY`) and the `-i` flag. The image is `yawgyamfiprem32/ambient-weather-mcp:latest`.

Is the server secure?

Yes. It runs as a non‑root user, stores no secrets inside the image, and credentials are passed via environment variables. Secrets are never logged, and each commit is scanned with TruffleHog.

What tools are available?

Three tools: `ping` (health check), `get_devices` (list all stations), and `get_current_weather` (full report for a specific station by MAC address).

Where can I get help or report issues?

The source code repository is at github.com/NanaGyamfiPrempeh30/ambient-weather-mcp. This is the primary place for documentation and issue tracking.

Comments

More Media & Design MCP servers

Vid Kraken

YouTube download API and MCP server. Download YouTube videos as MP4 (360p–4K) or audio as MP3/AAC, cut clips by start and end time, and get video metadata. No yt-dlp, proxies or cookies to maintain; 99.99% of downloads s

StoryStudio

Richard Ndumu

Remote MCP server for AI image, video, voice and music generation. Your agent creates and edits images with Nano Banana 2, GPT-Image 2 or FLUX 1.1 Pro, generates video with Veo 3.1 Fast, Seedance 2.5, Kling, MiniMax or W

Veltake Studio

Veltake AI

Drive Veltake Studio from any AI agent: create film and ad projects, have the Studio agent build scenes on the canvas, price and start renders, export edited cuts, and make single images, video, speech and music in one c

Artlist

Generate images, videos, music, and voice-overs directly from your AI agent. The full Artlist AI creative suite as an MCP server — works with Claude, ChatGPT, and VS Code, with more platforms coming soon.

Generate Greetings

Create greetings and personalized PNG cards for 30 occasions in 15 languages, including Hindi, Greek and Hebrew. Free remote MCP with curated phrases, occasion-matched backgrounds and four styles, including motivational.