Servidor MCP de WeatherAI

11 herramientas meteorológicas en tiempo real para tu asistente de IA — una URL, sin configuración.

El servidor MCP de WeatherAI proporciona a Claude Desktop, Cursor, Windsurf y cualquier asistente de IA compatible con MCP acceso instantáneo a información meteorológica en tiempo real, pronósticos, datos históricos, calidad del aire, astronomía, irradiancia solar y una interfaz meteorológica de IA en lenguaje sencillo.

Endpoint alojado: https://api.weatherai.io/mcp
Transporte: HTTP transmitible (sin estado, especificación MCP 2025-03-26)
Autenticación: Clave API mediante parámetro de consulta, encabezado o token Bearer
Nivel gratuito: 1.000 llamadas estándar/día · 50 llamadas premium/día

Inicio rápido

1. Obtén una clave API gratuita

Regístrate en weatherai.io — no se requiere tarjeta de crédito.

2. Añádelo a tu cliente de IA

Reemplaza YOUR_API_KEY con la clave de tu panel de control.

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o
%APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "weatherai": {
      "url": "https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY"
    }
  }
}

Reinicia Claude Desktop después de guardar.

Cursor

Ve a Cursor → Settings → MCP o edita ~/.cursor/mcp.json:

{
  "mcpServers": {
    "weatherai": {
      "url": "https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY"
    }
  }
}

Windsurf

Edita ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "weatherai": {
      "url": "https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY",
      "type": "http"
    }
  }
}

Cualquier otro cliente MCP (genérico mcp.json)

{
  "mcpServers": {
    "weatherai": {
      "url": "https://api.weatherai.io/mcp?apiKey=YOUR_API_KEY",
      "type": "http",
      "transport": "streamable-http"
    }
  }
}

3. Empieza a hacer preguntas sobre el tiempo

"What's the weather like in Tokyo right now?"
"Will it rain in London this weekend?"
"What were temperatures in Paris on 14 July 2023?"
"What's the air quality like in Beijing?"
"When does the sun set in Dubai today?"

Related MCP server: ambient-mcp

Herramientas disponibles

Las 11 herramientas se registran automáticamente — no se necesita configuración.

Detalles de las herramientas

get_current_weather

Devuelve temperatura, sensación térmica, humedad, velocidad/dirección del viento, índice UV, visibilidad, presión y nubosidad.

location  (required) City name, US zip, UK postcode, lat/lon, or IP address
units     (optional) "metric" | "imperial" — default: metric

get_weather_forecast

Máximas/mínimas diarias y desglose por horas para hasta 14 días, incluyendo probabilidad de precipitación e índice UV.

location  (required) City name, zip/postcode, coordinates, or IP address
days      (optional) 1–14 — default: 3
units     (optional) "metric" | "imperial" — default: metric

get_historical_weather

Tiempo real registrado hora a hora para cualquier fecha pasada.

location  (required) City name, zip/postcode, coordinates, or IP address
date      (required) YYYY-MM-DD format — must be a past date
units     (optional) "metric" | "imperial" — default: metric

get_future_weather

Pronóstico extendido mejorado por IA de 14 a 300 días en el futuro. Cuesta 2 créditos premium por solicitud.

location    (required) City name, zip/postcode, coordinates, or IP address
start_date  (required) YYYY-MM-DD — 14–300 days from today
end_date    (optional) YYYY-MM-DD — max 30 days per request
units       (optional) "metric" | "imperial" — default: metric

get_air_quality

Índice ICA en tiempo real más lecturas individuales de contaminantes (PM2.5, PM10, CO, NO2, SO2, O3).

location  (required) City name, zip/postcode, coordinates, or IP address

get_weather_alerts

Avisos activos emitidos por el gobierno sobre tormentas, inundaciones, calor y otros fenómenos meteorológicos.

location  (required) City name, zip/postcode, coordinates, or IP address

get_astronomy

Amanecer, atardecer, salida de la luna, puesta de la luna, nombre de la fase lunar y porcentaje de iluminación.

location  (required) City name, zip/postcode, coordinates, or IP address
date      (optional) YYYY-MM-DD — defaults to today

get_solar_data

Irradiancia solar (W/m²) y generación de energía diaria estimada (kWh/m²).

location  (required) City name, zip/postcode, coordinates, or IP address
date      (optional) YYYY-MM-DD — defaults to today
units     (optional) "metric" | "imperial" — default: metric

get_timezone

Nombre de la zona horaria IANA, desplazamiento UTC (horas), hora local actual y bandera de horario de verano activo.

location  (required) City name, zip/postcode, coordinates, or IP address

search_locations

Devuelve hasta 10 lugares coincidentes con nombre, región, país y coordenadas.

query  (required) Partial or full city/location name

ask_ai_weather ⭐

Haz cualquier pregunta meteorológica en lenguaje sencillo. La IA interpreta la intención, llama a las herramientas relevantes y devuelve una respuesta en lenguaje natural además de los datos JSON subyacentes. Cuesta 2 créditos premium por solicitud.

question  (required) e.g. "Will it be good weather for hiking in the Lake District next weekend?"

Autenticación

Se admiten tres métodos — todos equivalentes:

Se recomienda el parámetro de consulta para archivos de configuración de cliente. Usa encabezados para acceso programático.

Precios

Los créditos son prepagados — recarga desde tu panel de control. No se requiere suscripción.

Herramientas estándar: get_current_weather, get_weather_forecast, get_air_quality, get_weather_alerts, get_astronomy, get_timezone, search_locations

Herramientas premium: get_historical_weather, get_future_weather, get_solar_data, ask_ai_weather

Descubrimiento legible por máquina

Código fuente

Este repositorio contiene la implementación del servidor MCP. El servidor se ejecuta como parte de la plataforma WeatherAI.io en https://api.weatherai.io/mcp.

src/index.ts es una adaptación autónoma que también puede ejecutarse de forma independiente:

npm install
WEATHERAI_API_KEY=your_key npm start

El servidor independiente escucha en PORT (por defecto 3000) y expone el mismo endpoint /mcp.

Enlaces

• Sitio web: weatherai.io

• Documentación MCP: weatherai.io/mcp

• Documentación API: weatherai.io/docs

• Precios: weatherai.io/pricing

• Registro: weatherai.io/register

Licencia

MIT — ver LICENSE.

Creado por Zoomash Ltd, Inglaterra (N.º de empresa 7838145).