krxdart-mcp
In one line: This server is a pure proxy that lets you call Korean financial APIs (Open DART disclosure data and KRX market data) and fetch DART disclosure documents as text.
search_corp_code— Look up a company by name, 6-digit stock code, or 8-digit DART corp code (in-memory cached, up to 50 results).call_dart_api— Call any of ~70 Open DART JSON endpoints raw: corporate profiles, disclosure lists, financial statements (single/multi/all accounts, 2015+), dividend, major/minor shareholders, executives, employees, high-pay disclosures, equity filings (5% holdings, insider ownership), and 24 major-event reports (rights issues, CB, buybacks, mergers, etc.).call_krx_api— Call any of KRX's 31 OpenAPI services raw: KOSPI/KOSDAQ/KONEX daily quotes and issue info, warrants, ETF/ETN/ELW, indices (KOSPI, KOSDAQ, bond, derivatives), bonds (treasury, general, small), derivatives (futures, options), commodities (gold, oil, emissions), and ESG data.download_dart_document— Download a disclosure ZIP by 14-digit receipt number, extract its text body, optionally cap characters, and get a direct official viewer link (returns a TOC for periodic reports).Behavior: Pass-through of native parameters and responses with no transformation; API keys (
DART_API_KEY,KRX_API_KEY) are injected automatically via env config.
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., "@krxdart-mcp 삼성전자 최근 주가랑 공시 목록 알려줘"
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.
krxdart-mcp (Unofficial)
금융감독원 전자공시시스템(Open DART) 및 한국거래소(KRX) 공식 오픈API를 연동하는 비공식 MCP(Model Context Protocol) 서버입니다.
불필요한 가공 없이 Open DART와 KRX 순정 API의 파라미터 규격과 응답 JSON 구조를 1:1 원본 그대로 전달하는 순수 프록시(Pure Proxy) 역할을 수행합니다.
안내: 본 프로젝트는 개인이 오픈API를 활용하기 위해 만든 비공식 도구이며, 공시 및 시세 데이터의 권리는 각 기관(금융감독원, 한국거래소)에 있습니다.
제공 도구 (Tools)
도구 (Tool) | 설명 | 파라미터 |
| DART 고유번호 파일( |
|
| Open DART 공식 JSON 엔드포인트 70여 개 원본 호출 (재무제표, 기업개황, 공시목록, 배당, 지분 등) |
|
| 한국거래소(KRX) 공식 31개 OpenAPI 서비스 원본 호출 (일별시세, 종목기본정보, 지수, ETF, 채권 등) |
|
| DART 접수번호(14자리)의 공시 서류(ZIP)를 다운로드하여 텍스트 본문 추출 및 다이렉트 웹 링크 반환 (단일 공시는 본문 즉시 반환, 정기보고서는 목차 TOC 반환 후 핀포인트 조회 지원) |
|
Related MCP server: OpenDart-MCP
지원 API 엔드포인트 안내
1. DART 주요 엔드포인트 (call_dart_api)
DART에서 제공하는 모든 .json 엔드포인트를 호출할 수 있습니다.
기업개황 / 공시목록:
company.json,list.json재무제표 (2015년 이후):
fnlttSinglAcnt.json: 단일회사 주요 재무계정 (매출, 영업이익 등)fnlttMultiAcnt.json: 최대 10개사 다중회사 주요계정 일괄 비교fnlttSinglAcntAll.json: 전체 재무제표 모든 계정과목
정기보고서 세부정보:
alotMatter.json(배당),hyslrSttus.json(최대주주),mrhlSttus.json(소액주주)exctvSttus.json(임원),empSttus.json(직원),indvdlByPay.json(5억 이상 보수)
지분공시:
majorstock.json(대량보유 5%),elestock.json(임원/주요주주 소유)주요사항보고서:
ic.json(유상증자),cvbd.json(전환사채),act.json(자사주취득),mrg.json(합병) 등 24종
2. KRX 31개 공식 서비스 (call_krx_api)
주식 (sto):
stk_bydd_trd(코스피 일별시세),ksq_bydd_trd(코스닥),knx_bydd_trd(코넥스),stk_isu_base_info(코스피 종목정보),ksq_isu_base_info,knx_isu_base_info,sw_bydd_trd,sr_bydd_trd증권상품 (etp):
etf_bydd_trd(ETF 일별시세),etn_bydd_trd,elw_bydd_trd지수 (idx):
kospi_dd_trd(코스피지수),kosdaq_dd_trd(코스닥지수),krx_dd_trd,bon_dd_trd,drvprod_dd_trd채권 (bon):
kts_bydd_trd(국채),bnd_bydd_trd(일반채권),smb_bydd_trd(소액채권)파생상품 (drv):
fut_bydd_trd(선물),opt_bydd_trd(옵션),eqsfu_stk_bydd_trd(주식선물유가),eqkfu_ksq_bydd_trd,eqsop_bydd_trd,eqkop_bydd_trd일반상품 (gen):
gold_bydd_trd(금),oil_bydd_trd(석유),ets_bydd_trd(배출권)ESG (esg):
sri_bond_info,esg_index_info,esg_etp_info
MCP 설정
{
"mcpServers": {
"krxdart-mcp": {
"command": "npx",
"args": ["-y", "github:minking/krxdart-mcp"],
"env": {
"DART_API_KEY": "금융감독원_OpenDART_API_KEY",
"KRX_API_KEY": "한국거래소_오픈API_AUTH_KEY"
}
}
}
}라이선스
MIT License
Available Tools
4 toolscall_dart_apiA
금융감독원 Open DART의 모든 공식 엔드포인트를 호출하여 원본 JSON을 가공 없이 그대로 반환합니다. (DART_API_KEY 자동 주입)
Inputs: endpoint (required), params.
call_krx_apiA
한국거래소(KRX) 공식 오픈API(openapi.krx.co.kr)를 호출하여 원본 JSON을 가공 없이 그대로 반환합니다. (KRX_API_KEY 자동 주입)
Inputs: api_id (required), params.
download_dart_documentA
DART 공시 접수번호(14자리)의 공시서류(ZIP)를 다운로드하여 텍스트 본문과 웹 링크를 반환합니다. (반환된 direct_url은 원문 열람 공식 링크입니다)
Inputs: rcept_no (required), max_chars.
search_corp_codeA
회사명, 6자리 종목코드, 또는 8자리 고유번호로 기업을 검색합니다. (사명 변경 영향을 피하려면 6자리 종목코드[예: 005930] 검색 권장)
Inputs: query (required), limit.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clear primary purpose: one calls KRX APIs, one calls DART APIs, one downloads DART documents, and one searches corporate codes. There is minor potential overlap between call_dart_api and download_dart_document, but the descriptions distinguish raw API access from document retrieval.
All tool names follow a consistent lower_snake_case verb_noun pattern: call_*, download_*, search_*. The naming style is uniform and predictable despite covering different actions.
Four tools is well-scoped for a KRX/DART API wrapper. Each tool earns its place: raw API access for both providers, document downloading, and corporate code lookup.
The generic call_krx_api and call_dart_api tools expose all official endpoints, making the API surface effectively complete. The specialized document download and corporate search tools fill the most common convenience needs.
Related MCP Connectors
Powerful OpenDART API-based Korean corporate disclosure tools for accounting professionals
Search company disclosures and financial statements from the Korean market. Retrieve stock profile…
Korean company facts in English for AI agents: ~830 KOSPI-listed companies (DART profiles, KRW financials, recent filings) and ~110,000 corporate public procurement suppliers (12-month KONEPS contract awards), plus live National Tax Service business status checks. 4 tools, keyless, read-only.
FinBridge is a hosted MCP server for Korean company disclosures, read in English. DART filings and normalized financial statements, business segments, insider reports and 13F holdings, with US, Japanese and European filers on the same schema for comparison. Search a company by its registered English name or its Korean name. Every answer names the filing, the receipt number and the date. Korean price delivery is planned and not currently served. Docs: https://www.gronox.kr/docs
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to query Korean listed companies' financial statements, public disclosures, executive information, and shareholder structures in real-time using the DART API.2-
- AlicenseNot gradedqualityDmaintenanceProvides access to South Korea's DART (Data Analysis, Retrieval and Transfer System) financial disclosure system, enabling users to retrieve corporate information, financial statements, debt summaries, subsidiary investments, employee data, and stock information for Korean companies.6MIT
- FlicenseAqualityDmaintenanceEnables searching corporate disclosures from Korea's DART system, including company info, financial statements, and disclosure search.16-
- AlicenseNot gradedqualityDmaintenanceEnables AI-powered analysis of Korean stock market data and corporate disclosures using official DART and KRX APIs.ISC