About kuongeo
kuongeo is a small, dependency-free Python client for the open KUON GEO API, intended for developers querying geographic and public data about Japan. It also offers a CLI and returns values as published by the API without computing them in the client.
Key features
- 01Query warnings and observations for coordinates
- 02View hazards, heat, and price data
- 03Find community RTK bases in Japan
- 04Check daily station and poll counts
- 05Inspect archive contents and counts
Use cases
- 01Look up local information for Japanese coordinates
- 02Find community RTK base stations
- 03Check historical station counts
- 04Inspect KUON GEO archive data
MCP support
The kuongeo README lists an MCP server at https://kuongeo.com/mcp.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://kuongeo.com/mcpclaude mcp add --transport http kotaro-studio-kuongeo https://kuongeo.com/mcp{"mcpServers":{"kotaro-studio-kuongeo":{"type":"http","url":"https://kuongeo.com/mcp"}}}Open in Cursor{"servers":{"kotaro-studio-kuongeo":{"type":"http","url":"https://kuongeo.com/mcp"}}}Open in VS Code{"mcpServers":{"kotaro-studio-kuongeo":{"type":"http","url":"https://kuongeo.com/mcp"}}}{"mcpServers":{"kotaro-studio-kuongeo":{"serverUrl":"https://kuongeo.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
7| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | Yes | place or sight, Japanese or English; extra words like next/ferry/bus are fine |
| lang | enum | No | en | ja |
Details
From the project READMEkuongeo
A tiny, dependency-free Python client for the open KUON GEO API. No key, no account. Every value comes from the API as published; nothing is computed here.
pip install kuongeo
kuongeo here 42.924 143.196 # warnings, observation, hazards, heat, RTK and prices for a point in Japan
kuongeo bases --jp --lim 20 # community RTK base stations in Japan
kuongeo history # daily station/poll counts since 2026-07-03
kuongeo archive # what KUON GEO stores, counted hourly
import kuongeo
d = kuongeo.here(42.924, 143.196, lang="en")
print(d["municipality"]["code"], d["warnings"]["active"])
Endpoints and fields: https://kuongeo.com/developers · MCP server: https://kuongeo.com/mcp · ledger: https://kuongeo.com/archive
Warnings are relayed from the Japan Meteorological Agency; the official source is jma.go.jp. Please cite KUON GEO and the retrieval date. Data license CC BY 4.0; this package MIT.
Author: Kotaro Asahina (ORCID 0009-0002-2530-4142), Kuon R&D (空音開発).
Citable dataset (Zenodo, CC BY 4.0): KUON GEO community RTK base station availability log — https://doi.org/10.5281/zenodo.22064426
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.