`jma_station_search`

Pack: jma · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/jma_station_search for the schema, then POST the same URL with its arguments for the data.

Find Japan Meteorological Agency (JMA) observation stations (staffed weather stations and AMeDAS automatic stations) by name and/or prefecture. Returns station_id (the handle jma_past_daily and jma_climate_normals take), Japanese name, kana, romaji, coordinates, elevation, which elements the station observes (precipitation, temperature, wind, sunshine, humidity, snow) and whether it has closed. Name accepts romaji (“Nozawa Onsen”), katakana or kanji. Pass prefecture (English or Japanese name, or 2-digit JMA area number; Hokkaido is 14 sub-areas) to be fast; without it every area is scanned. Sourced from the Japan Meteorological Agency, past weather data search.

Parameters

Name	Type	Required	Description
`query`	string	no	Station name, e.g. “Nozawa Onsen”, “野沢温泉”, “Naha”.
`prefecture`	string	no	Prefecture or Hokkaido sub-area, e.g. “Nagano”, “長野県”, “48”.
`observes`	string	no	Only stations observing this element: precipitation, temperature, wind, sunshine, humidity or snow.
`limit`	number	no	Max stations to return (default 25, max 100).

Example call

Arguments

{
  "query": "Nozawa Onsen",
  "prefecture": "Nagano"
}

curl

curl -X POST https://gateway.pipeworx.io/jma/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"jma_station_search","arguments":{"query":"Nozawa Onsen","prefecture":"Nagano"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('jma_station_search', {
  "query": "Nozawa Onsen",
  "prefecture": "Nagano"
});

More examples

{
  "prefecture": "Nagano",
  "observes": "snow",
  "limit": 10
}

Response shape

Field	Type	Description
`found`	boolean	false when nothing matched; see reason
`reason`	string	Why nothing was returned
`data_as_of`	string	Date the data is current to (ISO)
`source`	string	Publisher and dataset
`notes`	string	Interpretation notes
`count`	number
`total_matches`	number
`stations`	array
`candidates`	array

Full JSON Schema

{
  "type": "object",
  "properties": {
    "found": {
      "type": "boolean",
      "description": "false when nothing matched; see reason"
    },
    "reason": {
      "type": "string",
      "description": "Why nothing was returned"
    },
    "data_as_of": {
      "type": "string",
      "description": "Date the data is current to (ISO)"
    },
    "source": {
      "type": "string",
      "description": "Publisher and dataset"
    },
    "notes": {
      "type": "string",
      "description": "Interpretation notes"
    },
    "count": {
      "type": "number"
    },
    "total_matches": {
      "type": "number"
    },
    "stations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "station_id": {
            "type": "string"
          },
          "prec_no": {
            "type": "number"
          },
          "block_no": {
            "type": "string"
          },
          "type": {
            "type": "string"
          },
          "name_ja": {
            "type": "string"
          },
          "name_kana": {
            "type": "string"
          },
          "name_romaji": {
            "type": "string"
          },
          "prefecture_ja": {
            "type": "string"
          },
          "prefecture_en": {
            "type": "string"
          },
          "latitude": {
            "type": [
              "number",
              "null"
            ],
            "description": "Decimal degrees north"
          },
          "longitude": {
            "type": [
              "number",
              "null"
            ],
            "description": "Decimal degrees east"
          },
          "elevation_m": {
            "type": [
              "number",
              "null"
            ],
            "description": "Metres"
          },
          "elements": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "closed": {
            "type": [
              "string",
              "null"
            ],
            "description": "Closure date, null if operating"
          }
        },
        "additionalProperties": true
      }
    },
    "candidates": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    }
  },
  "additionalProperties": true
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

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

Connect to just the jma pack

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

See Getting Started for client-specific install steps.

jma_station_search