Skip to main content
Glama

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개)

도구

엔드포인트

용도

dart_resolve

corpCode.xml

종목코드/회사명/고유번호 해석

search_disclosures

list.json

공시검색(기업·기간·유형)

get_company

company.json

기업개황(대표자·설립·업종 등)

get_document

document.xml

📌 공시서류 원문 텍스트

major_holders

majorstock.json

대량보유(5%) 상황보고

insider_holdings

elestock.json

임원·주요주주 소유상황

financial_statements

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 무료 발급)

환경변수

설명

OPENDART_API_KEY

OPEN DART 인증키 (필수)

DART_CACHE_DIR

corp_code 매핑 캐시 경로 (기본 data/)

Claude Code 등록

claude mcp add dart --scope user \
  --env "PYTHONPATH=$(pwd)/src" -- python3 -m dart_mcp.server

OPENDART_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 tools
dart_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

    A3.7/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: resolution, financial statements, company info, document retrieval, insider holdings, major holders, and search. No overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent snake_case pattern with verbs like 'get', 'search', 'resolve', and nouns/descriptors. No mixing of styles.

    Tool Count5/5

    7 tools is well-scoped for the domain of Korean financial disclosures. Each tool serves a necessary function without redundancy or missing essentials.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP Server for public disclosure information of Korean companies, powered by the dartpoint.ai API.
      3
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      3
      7 npm
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Enables querying South Korean stock disclosures, financial statements, and shareholder reports via the OpenDART API from any MCP-compatible client.
      87
      87 PyPI
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Provides 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.
      9
      MIT