Skip to main content
通常の HTTP 利用者は REST Reference と Quickstart を使ってください。 LLM / agent client から公開データを読む用途として、read-only MCP endpoint も提供しています。

​
Endpoint

POST https://data.kushiro.app/mcp
  • Transport: Streamable HTTP
  • Protocol: JSON-RPC 2.0
  • Auth: なし
  • Scope: read-only

​
Tools

Tool用途
list_sources公開中の source 一覧
get_source1 source の集計情報（metric ごとの件数・単位・期間範囲の内訳付き）
query_metrics数値データの検索
query_points施設・地点系データの検索
aggregate_metrics数値データの facet 集計（町別・年齢別・期間別などの sum / avg / latest / delta）
aggregate_points施設・地点系データの facet 集計（category / 属性ごとの件数）
points_near中心座標から半径内の地点を距離順で検索（distance_m 付き、cross-source 可）
各 tool の引数は tools/list が返す inputSchema を参照してください。query_metrics / aggregate_metrics は metric / metric_prefix / from / to / town / age / category_kind / category_code で絞り込めます。query_points / aggregate_points は category / attribute_filter / name_contains / address_contains / bounding box で絞り込めます。query_points はこれに加えて external_id でも絞り込めます。

​
tools/list example

curl https://data.kushiro.app/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

​
Prompts

prompts capability で、釧路市データ固有の分析テンプレートを配信しています。 client から prompts/list で一覧、prompts/get で本文（収集すべきデータ・分析観点・注意事項・出力形式）を取得できます。
Prompt用途
analyze_population_decline_structure人口減少の構造分析
rank_town_population_decline町別の人口減少ランキング
analyze_tourism_covid_impact観光入込客数の COVID 影響分析
analyze_fishery_long_term_trend水産取扱量の長期トレンド
assess_emergency_infrastructure_coverage防災インフラのカバレッジ評価
analyze_fiscal_health_trend財政健全性のトレンド
curl https://data.kushiro.app/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"prompts/list"}'
MCP endpoint は REST API reference とは別プロトコルです。HTTP client から普通にデータを読む場合は /api/v1/* を使ってください。