Skip to main content
Glama
deenesjakoruzh
pipeworx-io

mcp-openaq

by pipeworx-io
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

mcp-openaq

OpenAQ MCP — mediciones globales de calidad del aire a través de la API v3 de OpenAQ.

Parte de Pipeworx — una puerta de enlace MCP que conecta agentes de IA a más de 1476 fuentes de datos en vivo.

Herramientas

Herramienta

Descripción

air_quality_near

Obtén las lecturas más recientes de calidad del aire (PM2.5, PM10, O3, NO2, SO2, CO, etc.) en la estación de monitoreo MÁS CERCANA a una latitud/longitud. PREFIERE para "calidad del aire cerca de mí", "¿cuál es la calidad del aire en ?", "¿está el aire malo en ahora mismo?". Devuelve la estación más cercana con sus valores de contaminantes más recientes, además de otras estaciones cercanas.

find_stations

Encuentra estaciones de monitoreo de calidad del aire de OpenAQ por ubicación: un nombre de ciudad o lugar, coordenadas+radio (las más cercanas primero), un país (código ISO 3166-1 alpha-2), o un cuadro delimitador. Devuelve el id de la estación, nombre, país, coordenadas y los contaminantes que mide cada una (con ids de sensores), además de resolved_place que refleja las coordenadas a las que se resolvió un nombre de ciudad. Este es el primer paso para una serie histórica: encuentra la estación aquí, luego pasa su sensor_id a get_measurements. Se requiere al menos un argumento de ubicación: la herramienta no devolverá una lista global sin filtrar.

get_latest

Obtén la lectura más reciente de cada contaminante en una estación específica de OpenAQ (por id de ubicación de find_stations). Devuelve cada parámetro (PM2.5, O3, NO2, etc.) con su valor, unidades y hora de medición.

get_measurements

Obtén la serie temporal más reciente (agregados por hora o por día) para un solo sensor de OpenAQ (id de sensor de find_stations), de más reciente a más antiguo. Úsalo para tendencias de contaminantes a lo largo del tiempo en una estación/parámetro. Devuelve las ÚLTIMAS limit lecturas del sensor: ten en cuenta que muchos sensores de OpenAQ están archivados y dejaron de reportar hace años, por lo que "más reciente" puede legítimamente tener varios años de antigüedad: siempre lee las marcas de tiempo devueltas en lugar de asumir que los datos son actuales. Usa find_stations o get_latest para elegir un sensor que aún esté reportando.

Related MCP server: gios-air-mcp

Inicio rápido

Añádelo a tu cliente MCP (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "openaq": {
      "url": "https://gateway.pipeworx.io/openaq/mcp"
    }
  }
}

Qué sirve realmente este endpoint

tools/list en https://gateway.pipeworx.io/openaq/mcp devuelve las herramientas de la tabla anterior más las meta-herramientas compartidas de Pipeworx — ask_pipeworx, discover_tools, search_within, remember/recall y el resto del conjunto de la puerta de enlace. Por lo tanto, el número de herramientas que ves es mayor que el de esta tabla: un endpoint de un solo paquete actualmente lista aproximadamente 30 herramientas compartidas junto con las propias del paquete. La respuesta initialize de la conexión indica su alcance exacto y es la respuesta autoritativa para un día determinado.

Esto es deliberado, no una multiplexación accidental. Las meta-herramientas son lo que permiten que una conexión con alcance responda a una pregunta que este paquete no cubre — a través de ask_pipeworx, que enruta a través de todo el catálogo — sin que tengas que añadir un segundo servidor MCP. Actualmente no hay forma de montar un endpoint de paquete sin ellas; si los esquemas adicionales te cuestan más contexto de lo que vale el enrutamiento, conéctate a la puerta de enlace completa una vez en lugar de a varios endpoints de paquete.

O conéctate a la puerta de enlace completa de Pipeworx para obtener las herramientas de todos los paquetes listadas directamente, en lugar de solo las de este:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

Ambas URL llegan a la misma puerta de enlace y a las mismas 1476+ fuentes de datos. La única diferencia es qué herramientas del paquete se listan directamente; ask_pipeworx llega a todas desde cualquiera de las dos.

Uso con ask_pipeworx

En lugar de llamar a las herramientas directamente, puedes hacer preguntas en inglés sencillo — esto funciona tanto en el endpoint del paquete anterior como en la puerta de enlace completa:

ask_pipeworx({ question: "your question about Openaq data" })

La puerta de enlace elige la herramienta adecuada y completa los argumentos automáticamente.

Más

Licencia

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers