opendart_mcp 0.1.0

MCP (Model Context Protocol) server for OpenDART API. Provides LLM-accessible tools for Korean corporate disclosure, financial statements, and ownership data from FSS DART system.

opendart_mcp

MCP (Model Context Protocol) server for OpenDART API — Korea's Financial Supervisory Service electronic disclosure system.

Enables LLMs (Claude, GPT, etc.) to directly access Korean corporate disclosure data, financial statements, and ownership information.

Features

83개 OpenDART API를 MCP 도구로 완전 지원합니다.

그룹	도구 수	설명
DS001 공시정보	4	공시검색, 기업개황, 공시서류원본, 고유번호
DS002 정기보고서 주요정보	28	증자/감자, 배당, 주주, 임원, 보수, 감사, 채무증권 등
DS003 재무정보	7	재무제표, 주요계정, XBRL, 재무지표
DS004 지분공시	2	대량보유 상황보고, 임원·주요주주 소유보고
DS005 주요사항보고서	36	증자/감자, M&A, 소송, 사채발행, 자사주 등
DS006 증권신고서	6	지분증권, 채무증권, 합병, 분할 등

OpenDART API Coverage

전체 83개 API 완전 구현 (DS001~DS006)

DS001 — 공시정보 (4개)

#	API	설명	지원
1	공시검색	공시 유형별, 회사별, 날짜별 조건으로 공시보고서 검색	✅
2	기업개황	DART에 등록된 기업 개황정보 제공	✅
3	공시서류원본파일	공시보고서 원본파일 다운로드	✅
4	고유번호	공시대상회사의 고유번호, 회사명, 종목코드 조회	✅

DS002 — 정기보고서 주요정보 (28개)

#	API	설명	지원
1	증자(감자) 현황	자본금 변동 정보	✅
2	배당에 관한 사항	배당 관련 정보	✅
3	자기주식 취득 및 처분 현황	자사주 거래 현황	✅
4	최대주주 현황	주요 주주 정보	✅
5	최대주주 변동현황	주주 구성 변화	✅
6	소액주주 현황	소규모 주주 정보	✅
7	임원 현황	임직원 구성	✅
8	직원 현황	직원 규모 정보	✅
9	이사·감사의 개인별 보수현황	5억원 이상 개인별 보수	✅
10	이사·감사 전체의 보수현황 (보수지급금액)	이사·감사 전체 보수지급금액	✅
11	개인별 보수지급 금액(5억이상 상위5인)	상위 5인 보수 상세	✅
12	타법인 출자현황	투자 현황	✅
13	주식의 총수 현황	발행주식 정보	✅
14	채무증권 발행실적	채무증권 발행 내역	✅
15	기업어음증권 미상환 잔액	기업어음 잔액	✅
16	단기사채 미상환 잔액	단기사채 잔액	✅
17	회사채 미상환 잔액	회사채 잔액	✅
18	신종자본증권 미상환 잔액	신종자본증권 잔액	✅
19	조건부 자본증권 미상환 잔액	조건부 자본증권 잔액	✅
20	회계감사인의 명칭 및 감사의견	감사 의견	✅
21	감사용역체결현황	감사 계약 현황	✅
22	회계감사인과의 비감사용역 계약체결 현황	비감사용역 계약	✅
23	사외이사 및 그 변동현황	사외이사 현황	✅
24	미등기임원 보수현황	미등기임원 보수	✅
25	이사·감사 전체의 보수현황 (주주총회 승인금액)	주주총회 승인 보수	✅
26	이사·감사 전체의 보수현황 (보수지급금액 - 유형별)	유형별 보수	✅
27	공모자금의 사용내역	공모 자금 사용	✅
28	사모자금의 사용내역	사모 자금 사용	✅

DS003 — 정기보고서 재무정보 (7개)

#	API	설명	지원
1	단일회사 주요계정	XBRL 재무제표의 주요계정과목 (재무상태표, 손익계산서)	✅
2	다중회사 주요계정	복수 대상법인 주요계정 비교 조회	✅
3	재무제표 원본파일(XBRL)	XBRL 형식 재무제표 원본파일	✅
4	단일회사 전체 재무제표	XBRL 재무제표의 모든 계정과목	✅
5	XBRL택사노미재무제표양식	IFRS 기반 표준계정과목체계	✅
6	단일회사 주요 재무지표	주요 재무지표 정보	✅
7	다중회사 주요 재무지표	복수 대상법인 주요 재무지표	✅

DS004 — 지분공시 종합정보 (2개)

#	API	설명	지원
1	대량보유 상황보고	주식등의 대량보유(5%+) 상황보고	✅
2	임원·주요주주 소유보고	임원·주요주주 특정증권등 소유상황	✅

DS005 — 주요사항보고서 주요정보 (36개)

#	API	설명	지원
1	자산양수도(기타), 풋백옵션	자산양수도 및 풋백옵션 정보	✅
2	부도발생	부도발생 주요 정보	✅
3	영업정지	영업정지 주요 정보	✅
4	회생절차 개시신청	회생절차 개시신청 정보	✅
5	해산사유 발생	해산사유 발생 정보	✅
6	유상증자 결정	유상증자 결정 정보	✅
7	무상증자 결정	무상증자 결정 정보	✅
8	유무상증자 결정	유무상증자 결정 정보	✅
9	감자 결정	감자 결정 정보	✅
10	채권은행 등의 관리절차 개시	채권은행 관리절차 개시 정보	✅
11	소송 등의 제기	소송 제기 정보	✅
12	해외 증권시장 주권등 상장 결정	해외시장 상장 결정	✅
13	해외 증권시장 주권등 상장폐지 결정	해외시장 상장폐지 결정	✅
14	해외 증권시장 주권등 상장	해외시장 상장	✅
15	해외 증권시장 주권등 상장폐지	해외시장 상장폐지	✅
16	전환사채권 발행결정	전환사채 발행 결정 정보	✅
17	신주인수권부사채권 발행결정	신주인수권부사채 발행 결정	✅
18	교환사채권 발행결정	교환사채 발행 결정	✅
19	채권은행 등의 관리절차 중단	채권은행 관리절차 중단 정보	✅
20	상각형 조건부자본증권 발행결정	조건부자본증권 발행 결정	✅
21	자기주식 취득 결정	자사주 취득 결정 정보	✅
22	자기주식 처분 결정	자사주 처분 결정 정보	✅
23	자기주식취득 신탁계약 체결 결정	자사주 신탁 체결 결정	✅
24	자기주식취득 신탁계약 해지 결정	자사주 신탁 해지 결정	✅
25	영업양수 결정	영업 양수 결정 정보	✅
26	영업양도 결정	영업 양도 결정 정보	✅
27	유형자산 양수 결정	유형자산 양수 결정	✅
28	유형자산 양도 결정	유형자산 양도 결정	✅
29	타법인 주식 및 출자증권 양수결정	타법인 주식 양수 결정	✅
30	타법인 주식 및 출자증권 양도결정	타법인 주식 양도 결정	✅
31	주권 관련 사채권 양수 결정	주권 관련 사채 양수 결정	✅
32	주권 관련 사채권 양도 결정	주권 관련 사채 양도 결정	✅
33	회사합병 결정	회사합병 결정 정보	✅
34	회사분할 결정	회사분할 결정 정보	✅
35	회사분할합병 결정	회사분할합병 결정 정보	✅
36	주식교환·이전 결정	주식교환·이전 결정 정보	✅

DS006 — 증권신고서 주요정보 (6개)

#	API	설명	지원
1	지분증권	증권신고서(지분증권) 요약 정보	✅
2	채무증권	증권신고서(채무증권) 요약 정보	✅
3	증권예탁증권	증권신고서(증권예탁증권) 요약 정보	✅
4	합병	증권신고서(합병) 요약 정보	✅
5	주식의포괄적교환·이전	증권신고서(주식의포괄적교환·이전) 요약 정보	✅
6	분할	증권신고서(분할) 요약 정보	✅

Getting Started

1. Get an API Key

OpenDART에서 회원가입 후 인증키를 발급받으세요.

2. Install

dart pub global activate opendart_mcp

Or add to pubspec.yaml:

dependencies:
  opendart_mcp: ^0.1.0

3. Run

export OPENDART_API_KEY=your_api_key_here
opendart_mcp

4. Configure MCP Client

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "opendart": {
      "command": "dart",
      "args": ["run", "opendart_mcp"],
      "env": {
        "OPENDART_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add opendart -- dart run opendart_mcp

Usage Examples

Once connected, you can ask your LLM things like:

• "삼성전자의 최근 공시를 검색해줘"
• "SK하이닉스의 2024년 사업보고서 재무제표를 보여줘"
• "삼성전자와 SK하이닉스의 주요 재무지표를 비교해줘"
• "네이버의 대량보유 주주 현황은?"
• "삼성전자 2024년 배당 현황 알려줘"
• "LG에너지솔루션의 임원 현황을 보여줘"

Development

# Get dependencies
dart pub get

# Run in development
OPENDART_API_KEY=your_key dart run bin/opendart_mcp.dart

# Run tests
dart test

# Analyze
dart analyze

License

CC BY-ND 4.0 — see LICENSE for details.