Skip to main content
Glama
OpenKRX MCP Server

OpenKRX MCP Server

by RealYoungk

OpenKRX MCP Server

한국거래소(KRX) Open API를 MCP(Model Context Protocol) 도구로 제공하는 서버입니다.

지원 API (31개)

카테고리

도구 수

내용

지수 (idx)

5

KRX/KOSPI/KOSDAQ/채권/파생상품 지수 일별시세

주식 (sto)

8

KOSPI/KOSDAQ/KONEX 일별매매정보 + 종목기본정보

ETP (etp)

3

ETF/ETN/ELW 일별매매정보

채권 (bon)

3

국채/일반채권/소액채권 일별매매정보

파생상품 (drv)

6

선물/옵션 일별매매정보 (KOSPI/KOSDAQ 주식선물·옵션 포함)

일반상품 (gen)

3

석유/금/배출권 시장 일별매매정보

ESG (esg)

3

SRI채권/ESG ETP/ESG 지수 정보

Related MCP server: pykrx-mcp

설치 및 사용

사전 준비

KRX Open API에서 회원가입 후 API 인증키를 발급받으세요.

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "openkrx": {
      "command": "uvx",
      "args": ["openkrx-mcp"],
      "env": {
        "KRX_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Claude Code

claude mcp add openkrx -e KRX_API_KEY=<YOUR_API_KEY> -- uvx openkrx-mcp

직접 실행

# stdio (로컬)
KRX_API_KEY=<YOUR_API_KEY> uvx openkrx-mcp

# SSE (원격)
KRX_API_KEY=<YOUR_API_KEY> uvx openkrx-mcp --transport sse --port 8000

Docker

docker build -t openkrx-mcp .
docker run -e KRX_API_KEY=<YOUR_API_KEY> -p 8000:8000 openkrx-mcp

참고

  • 데이터는 2010년 이후 일별 데이터이며, 매일 오전 8시(KST)에 갱신됩니다.

  • 날짜 파라미터(basDd)는 YYYYMMDD 형식입니다.

  • API 호출 한도: 10,000건

라이선스

MIT

Available Tools

31 tools
get_bond_index_dailyB

채권지수 일별시세정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_derivatives_index_dailyB

파생상품지수 일별시세정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_elw_dailyB

ELW 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_emissions_market_dailyA

배출권시장 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_esg_etp_infoB

ESG ETP 정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_esg_index_infoB

ESG 지수 정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_etf_dailyA

ETF 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_etn_dailyA

ETN 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_futures_dailyB

선물 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_general_bond_dailyA

일반채권시장 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_gold_market_dailyC

금시장 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_konex_stock_base_infoA

코넥스(KONEX) 종목기본정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_konex_stock_dailyA

코넥스(KONEX) 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_kosdaq_index_dailyB

KOSDAQ 시리즈 지수 일별시세정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_kosdaq_stock_base_infoA

코스닥(KOSDAQ) 종목기본정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_kosdaq_stock_dailyC

코스닥(KOSDAQ) 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_kosdaq_stock_futures_dailyA

주식선물(코스닥) 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_kosdaq_stock_options_dailyA

주식옵션(코스닥) 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_kospi_index_dailyA

KOSPI 시리즈 지수 일별시세정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_kospi_stock_base_infoA

유가증권(KOSPI) 종목기본정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_kospi_stock_dailyC

유가증권(KOSPI) 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_kospi_stock_futures_dailyA

주식선물(유가증권) 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_kospi_stock_options_dailyA

주식옵션(유가증권) 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_krx_index_dailyB

KRX 시리즈 지수 일별시세정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_kts_bond_dailyA

국채전문유통시장(KTS) 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_oil_market_dailyA

석유시장 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_options_dailyB

옵션 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_small_bond_dailyA

소액채권시장 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_sri_bond_infoA

사회적책임투자(SRI) 채권 정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_stock_warrant_dailyA

신주인수권증권 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

get_subscription_rights_dailyA

신주인수권증서 일별매매정보를 조회합니다.

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 31 tools

    Disambiguation4/5

    Most tools are cleanly separated by market and instrument (e.g., KOSPI/KOSDAQ/KONEX stocks, ETF/ETN/ELW, bond sub-markets), so an agent can usually select the right one from the name alone. A few boundaries remain fuzzy without Korean market domain knowledge—KRX vs KOSPI index series, general futures/options vs stock futures/options, and the two warrant types—so it is not perfect.

    Naming Consistency5/5

    Every tool uses a get_ prefix and snake_case, following a consistent get_<market>_<record> pattern where record is daily, base_info, or info. This makes tool names highly predictable across the whole set.

    Tool Count2/5

    At 31 tools, this server is above the 25+ point where a flat tool list starts to burden an agent, even though each tool corresponds to a distinct KRX dataset. A parameterized interface grouping market and record type would be more appropriate for the apparent scope.

    Completeness4/5

    The daily-data surface is broad: stocks, indices, funds, bonds, derivatives, commodities, emissions, and ESG/SRI products all have dedicated tools, so core read-only workflows are covered. It lacks conveniences like date-range queries, intraday data, or unified search, but those fall outside the apparent daily-snapshot scope.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to query real-time and historical Korean stock market data from KRX (Korea Exchange) including indices, stocks, ETFs, bonds, derivatives, and commodities via MCP tools and resources.
      12 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides Korean stock market data (KOSPI, KOSDAQ, KONEX) including prices, fundamentals, investor trading, short selling, and indices via MCP protocol, enabling natural language queries from AI agents like ChatGPT and Claude.
      57 PyPI
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides Korean stock market data, including DART electronic disclosures and KRX trading information, enabling users to query company profiles, financial statements, and stock trade details via MCP clients.
      9
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      MCP server that provides Korean Exchange (KRX) Open API market data as tools, covering indices, stocks, ETPs, bonds, derivatives, commodities, and ESG.
      31
      MIT