# Weather MCP Server — Forecast & Air Quality (`muhammadafzal/weather-mcp-server`) Actor

Get current weather, forecasts, historical conditions, and air-quality data through an MCP-ready API for AI agents and automated workflows.

- **URL**: https://apify.com/muhammadafzal/weather-mcp-server.md
- **Developed by:** [Muhammad Afzal](https://apify.com/muhammadafzal) (community)
- **Categories:** AI, Automation, MCP servers
- **Stats:** 2 total users, 1 monthly users, 91.7% 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 — Forecast & Air Quality

> 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 <YOUR_APIFY_API_TOKEN>"
            }
        }
    }
}
```

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.

### What is Weather MCP Server?

**Weather MCP Server** turns the target data into structured, reusable results on Apify. Use it when you need repeatable collection for analysts, developers, agencies, researchers, and AI-agent workflows without maintaining a custom scraper or one-off integration. Run it manually, schedule recurring jobs, call it through the Apify API, or connect it to an AI agent through the Apify MCP server.

The Actor stores results in an Apify dataset, where they can be previewed and exported as JSON, CSV, Excel, XML, or RSS. Availability and completeness depend on the source, supplied inputs, public visibility, authentication requirements, and upstream rate limits.

### Use cases for Weather MCP Server

- Build structured datasets for research, reporting, enrichment, or monitoring.
- Automate repetitive collection with schedules, webhooks, and API calls.
- Feed clean records into spreadsheets, databases, CRMs, BI tools, AI agents, or RAG pipelines.
- Track changes over time by running the same validated input on a schedule.
- Replace fragile manual copy-and-paste work with a reproducible Apify workflow.

### How to use Weather MCP Server

1. Open the Actor input page and choose a focused, valid target.
2. Set a conservative result limit for the first run.
3. Start the Actor and inspect the dataset for coverage and field availability.
4. Export the results or connect the dataset to your downstream system.
5. Scale gradually and use scheduling, pagination, or proxies when supported.

#### Important input options

- `defaultLocation` — 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 wea
- `defaultLatitude` — Latitude for batch-mode connectivity test. Overrides defaultLocation. Example: 51.5074. NOT used in MCP tool calls.
- `defaultLongitude` — Longitude for batch-mode connectivity test. Overrides defaultLocation. Example: -0.1278. NOT used in MCP tool calls.

### API and automation example

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('muhammadafzal/weather-mcp-server').call({
  // Add the same input fields you use in the Apify Console.
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

### Related Apify Actors

Use these dedicated tools when a neighboring data source or workflow is a better match:

- [GitHub Repo Search — Stars, Language & Topics](https://apify.com/muhammadafzal/github-repo-search-stars-language-topics)
- [Google Scholar Scraper — Academic Papers & Citations](https://apify.com/muhammadafzal/google-scholar-scraper)
- [Google Maps MCP Scraper — Places, Reviews, Hours & Photos](https://apify.com/muhammadafzal/google-maps-scraper)
- [📰 Extract Google News Articles — AI & RAG Ready](https://apify.com/muhammadafzal/google-news-scraper)
- [Instagram Followers & Following Scraper — With Cookies](https://apify.com/muhammadafzal/instagram-following-scraper)
- [Leads Finder Pro - B2B Leads with Emails \[Apollo Alternative\]](https://apify.com/muhammadafzal/leads-finder-pro)
- [Yellow Pages US Scraper — Business Leads & Reviews](https://apify.com/muhammadafzal/yellow-pages-us-scraper)
- [Yellow Pages Australia Scraper — Business Leads & Reviews](https://apify.com/muhammadafzal/yellow-pages-au-scraper)
- [OpenTable Restaurants, Ratings & Reviews Scraper](https://apify.com/muhammadafzal/opentable-scraper)
- [Etsy Scraper Pro — Products, Prices, Reviews & Shop Data](https://apify.com/muhammadafzal/etsy-scraper-pro)

### Frequently asked questions

#### How many results can I scrape with Weather MCP Server?

The practical total depends on the source, input limits, pagination, available records, run timeout, and upstream restrictions. Start with a small run, verify the output, and increase the limit gradually.

#### Can I integrate Weather MCP Server with other apps?

Yes. Use Apify integrations, webhooks, schedules, dataset exports, Make, Zapier, Google Sheets, cloud storage, or your own application.

#### Can I use Weather MCP Server with the Apify API?

Yes. Start runs with the Apify REST API or an official Apify client, then retrieve records from the run's default dataset. Keep your API token in a secret or environment variable.

#### Can I use Weather MCP Server through an MCP Server?

Yes. The Apify MCP server can expose the Actor to compatible AI clients and agents. Review the input and expected cost before allowing an autonomous workflow to run it at scale.

#### Do I need proxies?

It depends on the source and volume. Use the default configuration first. For larger or geographically sensitive jobs, select an appropriate proxy configuration only when the Actor supports it.

#### Is it legal to scrape this data?

Scraping rules vary by source, jurisdiction, data type, and intended use. Collect only data you are authorized to access, respect applicable terms and privacy laws, and avoid restricted or personal data misuse. This documentation is not legal advice.

#### Your feedback

If a field is missing, a source layout has changed, or you need a supported use case documented, open an issue on the Actor page with a reproducible input and run ID.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# 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 <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/zgoYKJD3bwF9HY4Ql/builds/22aqmUuFO68jJVcuz/openapi.json