Skip to content

Hermes — Air Quality Intelligence

by southlondonscientific.com · remote · no sign-in to list tools · v0.2.0 · published by com.southlondonscientific

UK air quality MCP: live readings, historical trends, LAQM stats, WHO checks, knowledge base.

Changes · 2
CompareRegistry entry

15 tools: 2 change things and 13 only read.

Scanned Oct 21, 2026

1 check matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http hermes https://hermes.southlondonscientific.com/mcp

Findings

Matches of fixed checks, with the text they matched.

1 warn
  • Warnkb_get_practical_advice

    The description names a tool "contextual_advice" that this server does not list.

    Matched text

    description: "...sources), prefer the Clara MCP server's `contextual_advice` tool — it composes Hermes live readings with..."

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

15 tools

Changes things 2Claude Code: ask
  • assess_location_aqComprehensive air quality assessment for a location in one call.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Comprehensive air quality assessment for a location in one call. Combines nearby monitor discovery and current readings with DAQI into a single response. Use this as the first tool call for any air quality question about a location. For long-term trend analysis, use the dedicated `trend_analysis` tool. Returns a structured 'summary' dict with purpose-appropriate sections. Present the summary description to users first. Args: location: Postcode, place name, or "lat,lon". purpose: What the user needs — "general" (default), "health" (safety/worry), "exercise" (outdoor activity), or "planning" (homebuying/school assessment/long-term).
  • chart_aq_trendGenerate a time series chart of air quality data.No findings

    Why it is in this group

    • The description's first verb is "generate": a word for a change.
    Description, as the server wrote it
    Generate a time series chart of air quality data. Returns a PNG chart image with a brief text summary. Use this when users ask about trends, patterns, or want to visualise air quality over time. Args: start_date: Start date (ISO format, e.g. "2025-01-01"). end_date: End date (ISO format). location: Postcode, place name, or "lat,lon". Provide this or site_code. site_code: Direct site code. Provide this or location. pollutants: Optional filter, e.g. ["NO2", "PM2.5"]. Defaults to NO2, PM2.5, PM10, O3 if not specified. frequency: "hourly", "daily", or "monthly" (default "daily"). show_who_guidelines: Show WHO guideline reference lines (default True). show_daqi_bands: Show DAQI band background shading (default True).
Only reads 13Claude Code: allow
  • compare_locationsCompare current air quality across multiple locations side-by-side.No findings

    Why it is in this group

    • The name "compare_locations" says "compare": a word for reading.
    Description, as the server wrote it
    Compare current air quality across multiple locations side-by-side. Returns a ranked comparison by pollutant with DAQI bands and distance to nearest monitor. Useful for comparing development sites, school locations, or residential options. Args: locations: List of 2–6 locations (postcodes, place names, or "lat,lon"). pollutants: Optional filter, e.g. ["NO2", "PM2.5"]. Default: all available.
  • get_aqi_summaryGet an AQI assessment with health advice and WHO compliance check.No findings

    Why it is in this group

    • The name "get_aqi_summary" says "get": a word for reading.
    Description, as the server wrote it
    Get an AQI assessment with health advice and WHO compliance check. Returns a 'summary' with a plain-English health assessment, advice for general and at-risk populations, and WHO guideline context. Present the summary to users first. Also returns raw 'aqi' and 'who_compliance' data. Args: location: Postcode, place name, or "lat,lon". index: AQI system — "UK_DAQI" (default), "WHO", or "US_EPA". period: "current", "today", "this_week", or "this_month".
  • get_current_aqGet the most recent air quality readings near a location, with health context.No findings

    Why it is in this group

    • The name "get_current_aq" says "get": a word for reading.
    Description, as the server wrote it
    Get the most recent air quality readings near a location, with health context. Returns a 'summary' with a plain-English health assessment and advice for general and at-risk populations. Present the summary to users first. Also returns individual 'readings' from nearby monitors and 'metadata' about data freshness and sources. Args: location: Postcode, place name, or "lat,lon". radius_km: Search radius in kilometres (default 2.0). pollutants: Optional filter, e.g. ["NO2", "PM2.5"]. sources: Optional filter, e.g. ["AURN", "BREATHE_LONDON"].
  • get_historical_aqGet historical air quality data for a site or location, with health context.No findings

    Why it is in this group

    • The name "get_historical_aq" says "get": a word for reading.
    Description, as the server wrote it
    Get historical air quality data for a site or location, with health context. Returns a 'narrative' with plain-English interpretation of trends, WHO guideline exceedances, and guideline comparisons. Present the narrative to users first. Also returns raw 'data' and 'summary' statistics. Args: start_date: Start date (ISO format, e.g. "2025-01-01"). end_date: End date (ISO format). location: Postcode, place name, or "lat,lon". Provide this or site_code. site_code: Direct site code. Provide this or location. pollutants: Optional filter, e.g. ["NO2", "PM2.5"]. frequency: "hourly", "daily", or "monthly" (default "daily").
  • kb_get_guidelinesGet current air quality guideline and target values.No findings

    Why it is in this group

    • The name "kb_get_guidelines" says "get": a word for reading.
    Description, as the server wrote it
    Get current air quality guideline and target values. Args: framework: "WHO", "UK", "EU", or "all" (default). pollutant: Optional filter for a specific pollutant. Returns the full guidelines document (markdown).
  • kb_get_health_effectsGet health evidence summaries for a pollutant and population group.No findings

    Why it is in this group

    • The name "kb_get_health_effects" says "get": a word for reading.
    Description, as the server wrote it
    Get health evidence summaries for a pollutant and population group. Args: pollutant: "NO2", "PM2.5", "PM10", or "O3". population_group: "general", "children", "elderly", "respiratory", "cardiovascular", or "pregnant" (default "general"). Returns health effects document (markdown).
  • kb_get_local_contextGet area-specific contextual information.No findings

    Why it is in this group

    • The name "kb_get_local_context" says "get": a word for reading.
    Description, as the server wrote it
    Get area-specific contextual information. Args: area: "southwark", "london", or a specific neighbourhood. Returns local context document (markdown).
  • kb_get_monitoring_explainerGet plain-language explanations of monitoring methods and limitations.No findings

    Why it is in this group

    • The name "kb_get_monitoring_explainer" says "get": a word for reading.
    Description, as the server wrote it
    Get plain-language explanations of monitoring methods and limitations. Args: topic: One of "how_monitors_work", "regulatory_vs_lowcost", "what_readings_mean", "why_numbers_differ", "representativeness", "data_quality", "what_monitors_measure". Returns monitoring explainer document (markdown).
  • kb_get_practical_adviceGeneric protective-action guidance for a category of situation (NOT keyed to an individual user's context).1 finding

    Why it is in this group

    • The name "kb_get_practical_advice" says "get": a word for reading.

    Findings

    • Warn

      The description names a tool "contextual_advice" that this server does not list.

      Matched text

      description: "...sources), prefer the Clara MCP server's `contextual_advice` tool — it composes Hermes live readings with..."

      What this check looks for
    Description, as the server wrote it
    Generic protective-action guidance for a category of situation (NOT keyed to an individual user's context). For *personalised* advice that takes the user's specific health situation into account (asthma, pregnancy, gas cooker, tube commute, indoor sources), prefer the Clara MCP server's `contextual_advice` tool — it composes Hermes live readings with personal context to give an answer keyed to *this* user, *now*. Use this KB tool only as a fallback or when Clara is not available. Args: situation: One of "high_pollution_day", "commuting", "exercise", "school_run", "indoor_air", "planning_objection", "pregnancy", "child_asthma". Returns practical advice document (markdown).
  • list_monitorsList air quality monitoring sites near a location, with context.No findings

    Why it is in this group

    • The name "list_monitors" says "list": a word for reading.
    Description, as the server wrote it
    List air quality monitoring sites near a location, with context. Returns a 'summary' explaining how many monitors were found, their operational status, and what each monitor type represents. Present the summary to users first. Also returns a 'monitors' list with full metadata. Args: location: Postcode, place name, or "lat,lon". radius_km: Search radius in kilometres (default 5.0). sources: Optional filter, e.g. ["AURN", "BREATHE_LONDON"].
  • regulatory_statsGet LAQM Annual Status Report-style statistics for a location.No findings

    Why it is in this group

    • The description's first verb is "get": a word for reading.
    Description, as the server wrote it
    Get LAQM Annual Status Report-style statistics for a location. Returns annual means, percentiles, exceedance counts, data capture percentages, and compliance assessment against UK legal limits and WHO guidelines. Args: location: Postcode, place name, or "lat,lon". year: Calendar year to report on (default: most recent complete year). pollutants: Optional filter, e.g. ["NO2", "PM2.5"]. Default: all available.
  • time_patternsAnalyse when pollution is highest — hour of day, day of week, and month.No findings

    Why it is in this group

    • The description's first verb is "analyse": a word for reading.
    Description, as the server wrote it
    Analyse when pollution is highest — hour of day, day of week, and month. Returns temporal profiles showing typical patterns. Useful for advising on best times for outdoor exercise, school runs, or commuting. Args: location: Postcode, place name, or "lat,lon". pollutant: Pollutant to analyse — "NO2", "PM2.5", "PM10", "O3" (default "NO2"). period: Time window — "last_month", "last_3_months", "last_6_months", or "last_year" (default).
  • trend_analysisAnalyse the long-term trend in a pollutant near a location.No findings

    Why it is in this group

    • The description's first verb is "analyse": a word for reading.
    Description, as the server wrote it
    Analyse the long-term trend in a pollutant near a location. Uses Theil-Sen slope estimation with Mann-Kendall significance testing to determine whether air quality is improving, worsening, or stable. Robust to outliers and missing data. Returns a 'summary' with plain-English trend description and statistical details. Present the summary to users first. Args: location: Postcode, place name, or "lat,lon". pollutant: Pollutant to analyse — "NO2", "PM2.5", "PM10", "O3" (default "NO2"). years: Number of years of data to analyse (default 5, range 2–5). Requests outside this range are clamped; the response includes ``metadata.years_clamped`` and a note in ``summary`` when so.

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.2.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http hermes https://hermes.southlondonscientific.com/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__hermes__get_current_aq",
      "mcp__hermes__get_historical_aq",
      "mcp__hermes__get_aqi_summary",
      "mcp__hermes__list_monitors",
      "mcp__hermes__trend_analysis",
      "mcp__hermes__compare_locations",
      "mcp__hermes__regulatory_stats",
      "mcp__hermes__time_patterns",
      "mcp__hermes__kb_get_guidelines",
      "mcp__hermes__kb_get_health_effects",
      "mcp__hermes__kb_get_local_context",
      "mcp__hermes__kb_get_practical_advice",
      "mcp__hermes__kb_get_monitoring_explainer"
    ],
    "ask": [
      "mcp__hermes__assess_location_aq",
      "mcp__hermes__chart_aq_trend"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as hermes. Review it before you use it.