dart-mcp
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., "@dart-mcp Search for Samsung Electronics' latest quarterly report"
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.
dart-mcp
OPEN DART(금융감독원 전자공시) 를 MCP 서버로 노출합니다. 법무·내부통제 검토에 쓰이는 1차 공시 원본(공시서류 원문·지분공시·재무제표)을 도구로 제공합니다.
엔드포인트는 모두 OPEN DART 공식 API 경로를 원문 그대로 사용합니다(추측 없음). 토스 증권 등 다른 자격증명과 무관한 독립 서버로,
OPENDART_API_KEY만 필요합니다.
왜 별도 MCP인가 (법무 활용)
DART 공시는 금감원 1차 원본입니다. 매뉴얼·뉴스·해설서와 격이 다른, 인용 가능한 원천 자료입니다. 법무팀 스택과 결합해 검토 파이프라인을 구성합니다:
dart-mcp (공시검색 → rcept_no → 원문)
↓ get_document
kordoc MCP (HWP/PDF/표 추가 파싱)
↓
korean-law MCP (관련 법령·판례 대조)
↓
legal-analysis / legal-team (종합 판단 → J-ID 축적)예: "A사 합병 주요사항보고서 검토" → search_disclosures(kind=B) → get_document 원문
→ 상법·자본시장법 대조 → 판단.
Related MCP server: dart-mcp
제공 도구 (7개)
도구 | 엔드포인트 | 용도 |
| corpCode.xml | 종목코드/회사명/고유번호 해석 |
| list.json | 공시검색(기업·기간·유형) |
| company.json | 기업개황(대표자·설립·업종 등) |
| document.xml | 📌 공시서류 원문 텍스트 |
| majorstock.json | 대량보유(5%) 상황보고 |
| elestock.json | 임원·주요주주 소유상황 |
| fnlttSinglAcntAll.json | 단일회사 전체 재무제표 |
공시유형(kind): A 정기 · B 주요사항 · C 발행 · D 지분 · E 기타 · F 외부감사 ...
보고서(reprt_code): 11011 사업(연간) · 11012 반기 · 11013 1Q · 11014 3Q.
설치 & 설정
cd dart_mcp
pip install -e .
cp .env.example .env # OPENDART_API_KEY 입력 (https://opendart.fss.or.kr 무료 발급)환경변수 | 설명 |
| OPEN DART 인증키 (필수) |
| corp_code 매핑 캐시 경로 (기본 |
Claude Code 등록
claude mcp add dart --scope user \
--env "PYTHONPATH=$(pwd)/src" -- python3 -m dart_mcp.serverOPENDART_API_KEY 는 .env(gitignore)에서 자동 로드되어 claude 설정엔 저장되지 않습니다.
구조
dart_mcp/
├── pyproject.toml
└── src/dart_mcp/
├── config.py # OPENDART_API_KEY 로딩
├── client.py # 키 주입·status 처리·corp_code 캐시·원문 추출
├── server.py # FastMCP + 도구 등록
└── tools/
├── disclosures.py # 검색·기업개황·원문
├── ownership.py # 대량보유·임원소유
└── financials.py # 재무제표비고
corp_code 매핑(상장사 ~3,970개)은 최초 1회 다운로드 후 주간 캐시.
DART status
013(데이터 없음)은 정상 처리(빈 목록 반환), 그 외 오류는 메시지 반환.원문(
get_document)은 본문 텍스트를 추출하며max_chars초과 시truncated=true.
Available Tools
7 toolsdart_resolveA
회사 식별자 해석. query 는 6자리 종목코드 / 8자리 고유번호(corp_code) / 회사명 중 무엇이든 가능. corp_code·회사명·종목코드를 반환하며, 회사명이 모호하면 후보 목록(matches)도 함께 반환.
Inputs: query (required).
financial_statementsA
단일회사 전체 재무제표 (fnlttSinglAcntAll.json). company 는 종목코드/고유번호/회사명. year 는 사업연도 4자리(예: "2025"). reprt_code: 11011 사업(연간)/11012 반기/11013 1Q/11014 3Q. fs_div: CFS 연결 / OFS 별도.
Inputs: company (required), year (required), reprt_code, fs_div.
get_companyB
기업개황 (company.json). 대표자·설립일·주소·업종·결산월 등. company 는 종목코드/고유번호/회사명.
Inputs: company (required).
get_documentA
공시서류 원문 조회 (document.xml). rcept_no 는 접수번호 (search_disclosures 결과의 rcept_no). 원본 문서의 본문 텍스트를 추출해 반환하며, max_chars 초과 시 truncated=true. 1차 원본 인용용.
Inputs: rcept_no (required), max_chars.
insider_holdingsC
임원·주요주주 특정증권등 소유상황보고 (elestock.json). company 는 종목코드/고유번호/회사명. 내부자 보유·변동 검토용.
Inputs: company (required).
major_holdersB
대량보유 상황보고 (majorstock.json). 5% 이상 주식등 대량보유·변동 내역. company 는 종목코드/고유번호/회사명. 지배구조·경영권 분쟁 검토용.
Inputs: company (required).
search_disclosuresA
공시검색 (list.json). company 는 종목코드/고유번호/회사명. since~until 은 YYYYMMDD (기본 최근 90일). kind 는 공시유형 1글자 (A 정기 / B 주요사항 / C 발행 / D 지분 / E 기타 / F 외부감사 ...). final_only=True 면 최종보고서만. count 는 건수(최대 100).
Inputs: company (required), since, until, kind, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose: resolution, financial statements, company info, document retrieval, insider holdings, major holders, and search. No overlap or ambiguity.
All tool names follow a consistent snake_case pattern with verbs like 'get', 'search', 'resolve', and nouns/descriptors. No mixing of styles.
7 tools is well-scoped for the domain of Korean financial disclosures. Each tool serves a necessary function without redundancy or missing essentials.
The tool set covers all key operations: identifier resolution, company info, financials, insider/major shareholder reports, disclosure search, and document retrieval. No obvious gaps for the intended use case.
Maintenance
Related MCP Connectors
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
Powerful OpenDART API-based Korean corporate disclosure tools for accounting professionals
Search company disclosures and financial statements from the Korean market. Retrieve stock profile…
DART — Korea's Data Analysis, Retrieval and Transfer System. The Korean equivalent of SEC EDGAR.…
Related MCP Servers
AlicenseNot gradedqualityDmaintenanceMCP Server for public disclosure information of Korean companies, powered by the dartpoint.ai API.3Apache 2.0- AlicenseAqualityDmaintenanceMCP server for Korea's DART (Data Analysis, Retrieval and Transfer) electronic disclosure system, operated by the Financial Supervisory Service (FSS). Exposes company disclosures, company profiles, and financial statements via the OpenDART public API.37 npmMIT
- AlicenseCqualityBmaintenanceEnables querying South Korean stock disclosures, financial statements, and shareholder reports via the OpenDART API from any MCP-compatible client.8787 PyPIMIT
- 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