bldinit Kma Rest API

The kma-rest API from bldinit — 5 operation(s) for kma-rest.

GitHub OpenAPI

Operations 5

GET /api/v1/kma/VilageFcstInfoService_2.0/getUltraSrtNcst 초단기실황 — 현재 기상관측값 #
GET /api/v1/kma/VilageFcstInfoService_2.0/getUltraSrtFcst 초단기예보 — 향후 6시간 #
GET /api/v1/kma/VilageFcstInfoService_2.0/getVilageFcst 단기예보 — 3일 (동네예보) #
GET /api/v1/kma/MidFcstInfoService/getMidLandFcst 중기예보 — 3~10일 (육상 + 기온 merge) #
GET /api/v1/kma/WthrWrnInfoService/getWthrWrnList 기상특보 목록 (한파/호우/태풍/폭염 등 12종) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-kma-rest-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mcpweave-com-kma-rest-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: mcpweave Kma Rest API
  description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
  version: '2026-04-27'
tags:
- name: kma-rest
paths:
  /api/v1/kma/VilageFcstInfoService_2.0/getUltraSrtNcst:
    get:
      tags:
      - kma-rest
      summary: 초단기실황 — 현재 기상관측값
      description: '매시 40분 발표 → 10분 후 가용. T1H 기온 / RN1 강수량 / REH 습도 /

        WSD 풍속 / PTY 강수형태 등.


        ✅ Read-only (Cat A). 매장 운영 / 야외 행사 실시간 결정 용.'
      operationId: kma_get_current_observation
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: nx
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Nx
      - name: ny
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Ny
      - name: base_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Base Date
      - name: base_time
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Base Time
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/kma/VilageFcstInfoService_2.0/getUltraSrtFcst:
    get:
      tags:
      - kma-rest
      summary: 초단기예보 — 향후 6시간
      description: '매시 45분 발표 → 30분 후 가용. 배달 push 발송 / 시간대별 매장

        운영 결정.


        ✅ Read-only (Cat A).'
      operationId: kma_get_ultra_short_forecast
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: nx
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Nx
      - name: ny
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Ny
      - name: base_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Base Date
      - name: base_time
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Base Time
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/kma/VilageFcstInfoService_2.0/getVilageFcst:
    get:
      tags:
      - kma-rest
      summary: 단기예보 — 3일 (동네예보)
      description: '1일 8회 (02/05/08/11/14/17/20/23시) 발표. TMP 기온 / POP 강수확률 /

        PTY 강수형태 / SKY 하늘 등 12 category.


        ✅ Read-only (Cat A). 자영업자 wedge 최강.'
      operationId: kma_get_short_forecast
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: nx
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Nx
      - name: ny
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Ny
      - name: base_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Base Date
      - name: base_time
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Base Time
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/kma/MidFcstInfoService/getMidLandFcst:
    get:
      tags:
      - kma-rest
      summary: 중기예보 — 3~10일 (육상 + 기온 merge)
      description: '1일 2회 (06시 / 18시) 발표. mcpweave 가 getMidLandFcst (육상) +

        getMidTa (기온) 두 endpoint 동시 호출 후 merge — caller 는 단일

        응답으로 받음.


        regId 체계 비일관: 육상 11B00000 (전국) / 기온 11B10101 (서울)...

        mcpweave 가 자동 매핑.


        ✅ Read-only (Cat A). 이벤트 / 캠페인 / 시즌 발주 결정.'
      operationId: kma_get_midterm_forecast
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: reg_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Reg Id
      - name: temp_reg_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Temp Reg Id
      - name: tm_fc
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Tm Fc
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/kma/WthrWrnInfoService/getWthrWrnList:
    get:
      tags:
      - kma-rest
      summary: 기상특보 목록 (한파/호우/태풍/폭염 등 12종)
      description: '실시간. t6/t7 에 한국어 본문 (특보 종류·발효지역). 매장 임시

        휴업 결정 / 단골 손님 안내 trigger.


        ✅ Read-only (Cat A).'
      operationId: kma_get_weather_alert
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: stn_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Stn Id
      - name: from_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: From Date
      - name: to_date
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: To Date
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)