Skip to main content

openkrx-mcp

Overview Schema Source Related Servers Discussions Admin

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: krx-cli

설치 및 사용

사전 준비

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

# streamable-http (원격, 세션 없는 stateless 모드)
KRX_API_KEY=<YOUR_API_KEY> MCP_TRANSPORT=streamable-http PORT=8000 uvx openkrx-mcp

Docker

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

컨테이너는 기본적으로 MCP_TRANSPORT=streamable-http로 기동되며, http://localhost:8000/mcp 엔드포인트로 JSON-RPC 요청을 보내면 됩니다(세션 없는 stateless 모드 — 매 요청이 독립적으로 처리되며 Mcp-Session-Id 헤더가 필요 없습니다).

curl -X POST http://localhost:8000/mcp \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

참고

데이터는 2010년 이후 일별 데이터이며, 매일 오전 8시(KST)에 갱신됩니다.
날짜 파라미터(basDd)는 YYYYMMDD 형식입니다.
API 호출 한도: 10,000건
mcp SDK는 >=1.9.0,<2.0.0으로 버전을 고정하고 있습니다 — 2.0.0부터 mcp.server.fastmcp 모듈 구조가 크게 바뀌어 상한 없이 설치하면 빌드가 깨지니 주의하세요.

라이선스

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

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

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

Args: basDd: 기준일자 (YYYYMMDD)

Inputs: basDd (required). Returns: result

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…

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.4/5.0

Scored 2026-07-31 12:40 across 31 tools

Disambiguation4/5

Tools are mostly distinct by market and product type, but the index-related tools (KRX, KOSPI, KOSDAQ, bond, derivatives) could be confused due to similar naming and daily price descriptions. Stock and bond tools are clearly separated by market segment.

Naming Consistency5/5

All tools follow a consistent get_<market>_<data_type> pattern with lowercase snake_case. The use of 'daily', 'base_info', and 'info' suffixes is predictable across the set.

Tool Count2/5

At 31 tools, the set is significantly larger than the typical MCP server, exceeding the 25-tool threshold. Many tools are specific market variants, but the count still feels heavy for an agent to navigate.

Completeness4/5

The tool surface covers a broad range of Korean financial markets including indices, equities, bonds, derivatives, and commodities. Minor gaps exist such as missing currency or corporate action data, but the core daily data retrieval is well-covered.

Maintenance

ActivityInactive

ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Financial Modeling Prep MCP ServerA
io.github.imbenrabi
MCP server for Financial Modeling Prep API with 250+ financial data tools
Finance Open Data
51149
https://financial-modeling-prep-mcp-server-production.up.railway.app/mcp
Intrinio
com.intrinio
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
Finance Data Platforms
1
https://intrinio-mcp.intrinio.com/mcp
NarwhalB
com.narwhalapi
One API and MCP server for financial and economic data: markets, economics, companies and more.
Finance
801
https://api.narwhalapi.com/mcp
Finance MCPA
io.github.aowang-ai
Hosted MCP server for SEC, FRED, Polymarket, Deribit, OKX, and FMP.
Finance Cryptocurrency Government Data
31
https://finance-mcp.com/mcp

Related MCP Servers

kookmin-stock
Finance Search
JooSeunghyeon
F
license
A
quality
D
maintenance
MCP server that provides Korean stock market data including indices, top gainers, stock quotes, news, fundamentals, and buy recommendations. Enables LLMs to access real-time and historical Korean stock information.
Updated 6 months ago (2026-05-02 06:08 UTC)
6
-
krx-cli
Finance Research & Data
kyo504
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.
Updated 8 months ago (2026-03-20 07:17 UTC)
27 npm
1
MIT
OpenKRX MCP Server
Finance Open Data
RealYoungk
A
license
B
quality
D
maintenance
Provides Korean Exchange (KRX) Open API data as MCP tools, supporting 31 APIs for indices, stocks, ETP, bonds, derivatives, commodities, and ESG.
Updated 9 months ago (2026-02-20 13:06 UTC)
31
33 PyPI
2
MIT
fin-products-tools
Finance Open Data
hyeonseo2
A
license
Not graded
quality
D
maintenance
MCP server that provides tools to query Korean financial products (savings, deposits, pensions, mortgages, loans) via the FSS Open API, enabling search by company or product type.
Updated 8 months ago (2026-03-21 07:17 UTC)
2
MIT