jjlabsio avatar

Korea Stock Mcp

jjlabsio/korea-stock-mcp

Connects Claude to Korean stock market data through two official APIs: DART for corporate disclosures and financial statements, and KRX for daily trading data across KOSPI, KOSDAQ, and KONEX markets. You get tools to search filings by company and date, pull XBRL financial statements with full account details, and query stock prices, trading volume, and market cap. Handles large disclosure documents by returning a table of contents first, then letting Claude fetch specific sections to avoid token limits. Useful when you're analyzing Korean equities or need to pull regulatory filings and correlate them with price action. Requires API keys from both DART and KRX, with KRX approval taking about a day.

GitHub stars
144
tools
8
auth
Secret needed
transport
STDIO
env vars
2
last updated
Sep 19, 2025

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

get_disclosure_listSearch disclosure reports by type, company, and date

Search disclosure reports by type, company, and date

No parameter schema in public metadata yet.

get_corp_codeProvides unique codes, company names, and stock codes of DART-registered disclosure companies

Provides unique codes, company names, and stock codes of DART-registered disclosure companies

No parameter schema in public metadata yet.

get_disclosureParse original disclosure report files through DART API

Parse original disclosure report files through DART API

No parameter schema in public metadata yet.

get_financial_statementXBRL financial statements for listed and major unlisted companies

XBRL financial statements for listed and major unlisted companies

No parameter schema in public metadata yet.

get_stock_base_infoBasic information for KOSPI, KOSDAQ, and KONEX listed stocks

Basic information for KOSPI, KOSDAQ, and KONEX listed stocks

No parameter schema in public metadata yet.

get_stock_trade_infoDaily trading data for KOSPI, KOSDAQ, and KONEX stocks

Daily trading data for KOSPI, KOSDAQ, and KONEX stocks

No parameter schema in public metadata yet.

get_market_typeQuery market classification (KOSPI/KOSDAQ/KONEX) by stock code

Query market classification (KOSPI/KOSDAQ/KONEX) by stock code

No parameter schema in public metadata yet.

get_today_dateProvides current date in YYYYMMDD format

Provides current date in YYYYMMDD format

No parameter schema in public metadata yet.

Sponsors

Configuration

DART_API_KEY*secret

DART API key for the service

KRX_API_KEY*secret

KRX API key for the service

Readme

Korea Stock MCP Server

🇰🇷 한국어 | 🇺🇸 English

🚀 Korea Stock MCP가 오픈소스 MCP에서 한 단계 더 나아갑니다. 정확한 한국 주식 데이터를 바탕으로, AI가 더 믿을 수 있는 답변을 제공하도록 돕는 새로운 서비스를 준비하고 있습니다. 새로운 서비스의 방향을 확인해보세요.

한국 주식 분석을 위한 MCP 서버입니다.
DART(전자공시시스템)와 KRX(한국거래소) 공식 API를 통해 주가 정보와 공시 자료 기반의 AI분석이 가능합니다.

💬 개선 요청 & 피드백 환영합니다! 사용하면서 불편한 점이나 개선 아이디어가 있으시면 편하게 이메일 주세요. 빠르게 확인하고 반영하겠습니다. 📧 wowlxx28@gmail.com

🎯 주요 기능

  • 🔍 공시검색 - 회사별, 기간별 공시 검색
  • 📊 공시 데이터 - 공시보고서 원본파일 파싱한 데이터 제공
  • 💼 재무제표 분석 - XBRL 기반 상세 재무 데이터
  • 📈 주식 데이터 - KRX(코스피/코스닥) 일별 주가정보, 종목 기본정보

⚡ 빠른 시작

1️⃣ API KEY 발급

먼저 DART와 KRX의 API KEY를 발급받아야 합니다.

📝 DART API KEY 발급
  1. 회원가입: OPEN DART 회원가입
  2. 키 신청: 인증키 신청 페이지에서 API KEY 신청
  3. 키 확인: 오픈API 이용현황에서 발급된 API KEY 확인
📈 KRX API KEY 발급

View the full README on GitHub

Details

Repository
github.com/jjlabsio/korea-stock-mcp
Package
korea-stock-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from jjlabsio