Ambient Weather MCP
About
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
Explore
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Ambient Weather MCPCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
docker run -i --rm -e AMBIENT_API_KEY="..." -e AMBIENT_APP_KEY="..." yawgyamfiprem32/ambient-weather-mcp:latest
The -i flag is required. Stdio MCP servers exit immediately on EOF without it.
- ping — health check confirming the server is running and keys are configured
- get_devices — lists all weather stations on your account with their latest readings
- get_current_weather — full weather report for a specific station, by MAC address
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"ambient weather mcp": {
"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>"
}
}
}
}
}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>"
}
}
}Tools
- ping — health check confirming the server is running and keys are configured - get_devices — lists all weather stations on your account with their latest readings - get_current_weather — full weather report for a specific station, by MAC addressQuick start
docker run -i --rm -e AMBIENT_API_KEY="..." -e AMBIENT_APP_KEY="..." yawgyamfiprem32/ambient-weather-mcp:latest The -i flag is required. Stdio MCP servers exit immediately on EOF without it.Get API keys
Generate both an Application Key and an API Key at dashboard.ambientweather.net/account.Security
Runs as a non-root user. No embedded secrets. Credentials are provided via environment variables and never logged. TruffleHog scans every commit and push.Source
github.com/NanaGyamfiPrempeh30/ambient-weather-mcp — MIT licensed.Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
