OpenKRX MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@OpenKRX MCP Server What is the KOSPI index value for yesterday?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 8000Docker
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 toolsget_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
Scored across 31 tools
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.
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.
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.
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
Related MCP Connectors
China A-share market data over MCP: 22 tools for quotes, K-line, financials, money flow, top-trader boards, sectors, macro, convertible bonds and factor screening. Five tools need no API key, so you can connect and try it immediately.
One API and MCP server for financial and economic data: markets, economics, companies and more.
33 pay-per-call market and news data tools over MCP with free discovery and x402 payments.
Financial data and research MCP for US/CN/JP equities: filings, statements, ownership, signals.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables 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 npm1MIT

pykrx-mcpofficial
AlicenseNot gradedqualityDmaintenanceProvides 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 PyPI3MIT- AlicenseAqualityDmaintenanceProvides 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.9MIT
- AlicenseBqualityDmaintenanceMCP server that provides Korean Exchange (KRX) Open API market data as tools, covering indices, stocks, ETPs, bonds, derivatives, commodities, and ESG.31MIT