# Weather MCP Server — Forecast, Historical & Air Quality (`muhammadafzal/weather-mcp-server`) Actor MCP server exposing current weather, multi-day forecasts, historical weather, and air quality data as agent-callable tools. Connect Claude, Cursor, ChatGPT, n8n, or any MCP-compatible agent to live weather data worldwide. No API key required. - **URL**: https://apify.com/muhammadafzal/weather-mcp-server.md - **Developed by:** [Muhammad Afzal](https://apify.com/muhammadafzal) (community) - **Categories:** AI, Automation, MCP servers - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 mcp tool calls This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Weather MCP Server — Current, Forecast, Historical & Air Quality for AI Agents > MCP server exposing **4 weather tools** for AI agents. Connect Claude, Cursor, ChatGPT, n8n, OpenAI Agents SDK, or any MCP-compatible client to live weather data worldwide. No API key required. ### What it does This Actor runs a [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server in Standby mode on the Apify platform. It exposes four agent-callable tools that fetch weather data from the free [Open-Meteo API](https://open-meteo.com) (no API key, commercially licensed): | Tool | What it returns | |------|-----------------| | `get_current_weather` | Current temperature, feels-like, humidity, precipitation, cloud cover, pressure, wind speed/direction/gusts, day/night flag, weather description, and a one-line summary | | `get_weather_forecast` | 1–16 day forecast with per-day high/low temp, feels-like, precipitation, rain, snowfall, precipitation probability, wind, sunrise/sunset, UV index; optional hourly breakdown | | `get_historical_weather` | Historical weather observations for any date range — per-day temp, precipitation, wind, sunshine duration | | `get_air_quality` | Current air quality — PM10, PM2.5, CO, NO₂, SO₂, O₃, UV index, European AQI, US AQI, and category label (Good/Moderate/Unhealthy/etc.) | ### Use cases - **AI assistants** querying current weather and multi-day forecasts for user-specified locations - **Travel and trip planning agents** that need up-to-date conditions and short-term forecasts - **Logistics and supply chain** automation checking weather along routes - **Agriculture and field-operations** planning (frost risk, irrigation windows) - **Air quality monitoring** and health advisory applications - **LLM-driven planning workflows** that require weather context during reasoning - **n8n / Make / Zapier** integrations for weather-triggered automations ### How to use #### Connect to Claude, Cursor, or any MCP client Add the server to your MCP client configuration: ```json { "mcpServers": { "weather-mcp-server": { "url": "https://muhammadafzal--weather-mcp-server.apify.actor/mcp", "headers": { "Authorization": "Bearer " } } } } ```` Get your Apify API token from the [Apify Console → Account → Integrations](https://console.apify.com/account/integrations). #### Call tools programmatically Each tool accepts either a city name (`location`) or direct coordinates (`latitude` + `longitude`): ``` get_current_weather(location="London") get_weather_forecast(location="Tokyo", forecastDays=5, includeHourly=true) get_historical_weather(location="Berlin", startDate="2024-01-01", endDate="2024-01-31") get_air_quality(location="Delhi") ``` ### Pricing This Actor uses pay-per-event pricing: | Event | Price | |-------|-------| | Actor Start | $0.00005 per event (one per GB of memory, minimum one) | | MCP Tool Call | $0.005 per tool invocation | **Typical cost:** A single weather lookup costs ~$0.005. A week of daily weather checks for 10 cities = ~$0.35. ### Data sources - **[Open-Meteo Forecast API](https://open-meteo.com/en/docs)** — free, no API key, commercially licensed - **[Open-Meteo Historical Weather API](https://open-meteo.com/en/docs/historical-weather-api)** — archive data from 1940 onwards - **[Open-Meteo Air Quality API](https://open-meteo.com/en/docs/air-quality-api)** — CAMS-based air quality data - **[Open-Meteo Geocoding API](https://open-meteo.com/en/docs/geocoding-api)** — city name → coordinates (OpenStreetMap-based) No API keys, no logins, no rate limits beyond fair use. ### Technical details - **Language:** Python 3.12 - **Framework:** [FastMCP](https://gofastmcp.com/) + [uvicorn](https://www.uvicorn.org/) - **Transport:** Streamable HTTP (MCP standard) - **Mode:** Standby (always-ready, auto-scales with demand) - **Endpoint:** `https://muhammadafzal--weather-mcp-server.apify.actor/mcp` ### Input In Standby/MCP mode, tool calls are made through the `/mcp` endpoint — the Actor input is only used for batch-mode connectivity tests. | Field | Type | Default | Description | |-------|------|---------|-------------| | defaultLocation | string | `""` | City name for batch-mode test | | defaultLatitude | number | `0` | Latitude for batch-mode test | | defaultLongitude | number | `0` | Longitude for batch-mode test | ### Output Each tool call returns a structured JSON object. The dataset also stores each tool call result for auditing. ### Export scraped data, run the scraper via API, schedule and monitor runs, or integrate with other tools Apify gives you access to the raw data, APIs, webhooks, and automation tools you need to build data pipelines. Export to JSON, CSV, Excel, or send to Google Sheets, Airtable, or any webhook via integrations. ### Support Found a bug or have a feature request? [Open an issue](https://apify.com/muhammadafzal/weather-mcp-server) on the Apify Store page. # Actor input Schema ## `defaultLocation` (type: `string`): City name for batch-mode connectivity test. In Standby/MCP mode this is ignored — each tool call provides its own location. Example: 'London'. Use this field when the user says 'test the weather server' or 'check if it works'. NOT used in MCP tool calls. ## `defaultLatitude` (type: `number`): Latitude for batch-mode connectivity test. Overrides defaultLocation. Example: 51.5074. NOT used in MCP tool calls. ## `defaultLongitude` (type: `number`): Longitude for batch-mode connectivity test. Overrides defaultLocation. Example: -0.1278. NOT used in MCP tool calls. ## Actor input object example ```json { "defaultLocation": "London", "defaultLatitude": 0, "defaultLongitude": 0 } ``` # Actor output Schema ## `mcpEndpoint` (type: `string`): The MCP server endpoint. Connect MCP clients (Claude, Cursor, etc.) to this URL with an Apify API token as Bearer auth. ## `weatherResults` (type: `string`): Weather data records from tool calls, stored in the default dataset. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "defaultLocation": "London" }; // Run the Actor and wait for it to finish const run = await client.actor("muhammadafzal/weather-mcp-server").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "defaultLocation": "London" } # Run the Actor and wait for it to finish run = client.actor("muhammadafzal/weather-mcp-server").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "defaultLocation": "London" }' | apify call muhammadafzal/weather-mcp-server --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=muhammadafzal/weather-mcp-server", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Weather MCP Server — Forecast, Historical & Air Quality", "description": "MCP server exposing current weather, multi-day forecasts, historical weather, and air quality data as agent-callable tools. Connect Claude, Cursor, ChatGPT, n8n, or any MCP-compatible agent to live weather data worldwide. No API key required.", "version": "1.0", "x-build-id": "4RijL9zmqIabXuFYg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/muhammadafzal~weather-mcp-server/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-muhammadafzal-weather-mcp-server", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/muhammadafzal~weather-mcp-server/runs": { "post": { "operationId": "runs-sync-muhammadafzal-weather-mcp-server", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/muhammadafzal~weather-mcp-server/run-sync": { "post": { "operationId": "run-sync-muhammadafzal-weather-mcp-server", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "defaultLocation": { "title": "Default Location (test mode)", "type": "string", "description": "City name for batch-mode connectivity test. In Standby/MCP mode this is ignored — each tool call provides its own location. Example: 'London'. Use this field when the user says 'test the weather server' or 'check if it works'. NOT used in MCP tool calls.", "default": "" }, "defaultLatitude": { "title": "Default Latitude (test mode)", "type": "number", "description": "Latitude for batch-mode connectivity test. Overrides defaultLocation. Example: 51.5074. NOT used in MCP tool calls.", "default": 0 }, "defaultLongitude": { "title": "Default Longitude (test mode)", "type": "number", "description": "Longitude for batch-mode connectivity test. Overrides defaultLocation. Example: -0.1278. NOT used in MCP tool calls.", "default": 0 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```