About OpenDART MCP Server
OpenDART MCP Server is an MCP server in the Developer Tools category: openDART MCP server with 85 disclosure APIs and verified financial statement Excel workbooks. It has been installed 0 times through Conduid.
The repository has 2 stars and 0 forks.
Install
uvx
uvx opendart-mcp-serverpip
pip install opendart-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
✦
Ask AI about OpenDART MCP Server
Powered by Claude · Grounded in docs
I know everything about OpenDART MCP Server. Ask me about installation, configuration, usage, or troubleshooting.
Security checks
- ·README presentNot checked yet.
- ·License declaredNot checked yet.
- ·Tests presentNot checked yet.
- ·Dependencies pinnedNot checked yet.
- ·No dynamic code executionNot checked yet.
- ·Scoped permissionsNot checked yet.
README
OpenDART MCP Server
한국 금융감독원 OpenDART API를 Claude에서 바로 사용할 수 있는 MCP(Model Context Protocol) 서버입니다.
API를 발급받아 Claude 커스텀 커넥터로 바로 연결할 수 있습니다.
Features
- Open DART API 전부 지원: Open DART에서 제공하는 API(83개)를 전부 지원합니다.
- Vercel 배포: ngrok/터널링 없이 커스텀 커넥터로 바로 연결 가능합니다.
- URL 기반 API 키: 커넥터 URL에 키를 포함하여 설정 없이 즉시 사용 가능합니다.
- 마크다운 출력: Claude에서 깔끔하게 렌더링되는 테이블 형태로 출력합니다.
- Corp Code 캐싱: 9만+ 기업 목록을 인메모리 캐싱 (24시간 TTL)
Quick Start
1. OpenDART API 키 발급
OpenDART에서 회원가입 후 API 인증키를 발급받으세요.
2. Claude에 연결
- claude.ai 접속
- 사용자 지정 > 커넥터 > 사용자 지정 커넥터 추가
- URL 입력:
https://your-project.vercel.app/api/mcp?opendart_key=YOUR_API_KEY - 연결 완료! 별도 설정 없이 바로 사용 가능
Tools
Config (2개)
| Tool | 설명 |
|---|---|
set_api_key |
OpenDART API 키를 세션에 설정 |
get_api_key_status |
API 키 설정 여부 확인 |
회사 검색 & 정보 (3개)
| Tool | 설명 |
|---|---|
opendart_search_company |
한글/영문 이름 또는 종목코드로 회사 검색 → corp_code 획득 |
opendart_get_company_info |
기업 개황 (대표이사, 주소, 업종 등) |
opendart_search_disclosure |
공시 검색 (기간, 유형, 페이지네이션) |
재무 정보 (7개)
| Tool | 설명 |
|---|---|
opendart_single_financial_accounts |
단일회사 주요계정 (매출, 영업이익, 자산 등) |
opendart_multi_financial_accounts |
다중회사 주요계정 비교 (최대 100개) |
opendart_full_financial_statement |
전체 재무제표 (BS, IS, CF 전 항목) |
opendart_single_financial_index |
단일회사 재무지표 (수익성, 안정성, 성장성) |
opendart_multi_financial_index |
다중회사 재무지표 비교 |
opendart_xbrl_taxonomy |
XBRL 표준 계정과목 분류 |
opendart_dividend_info |
배당 관련 정보 |
정기보고서 세부 항목 (24개)
| Category | Tools | 설명 |
|---|---|---|
| 주주 | 3 | 최대주주, 최대주주 변동, 소액주주 현황 |
| 임원/직원 | 3 | 임원 현황, 직원 현황, 사외이사 |
| 보수 | 5 | 개인별, 전체, 상위5인, 미등기임원, 승인총액 |
| 주식 | 3 | 발행주식총수, 증자/감자 현황, 자기주식 |
| 감사 | 3 | 감사의견, 회계감사 계약, 비감사 서비스 |
| 채무증권 | 5 | 발행실적, 기업어음, 단기사채, 회사채, 신종자본증권, 조건부자본증권 |
| 투자/자금 | 3 | 타법인 출자, 공모자금, 사모자금 사용내역 |
주주 보유 보고 (2개)
| Tool | 설명 |
|---|---|
opendart_major_stockholding |
대량보유 상황보고 (5% 이상) |
opendart_executive_stockholding |
임원/주요주주 보유 보고 |
주요사항보고서 (36개)
| Category | Tools | 설명 |
|---|---|---|
| 자본 변동 | 4 | 유상증자, 무상증자, 유무상증자, 감자 |
| 조직 변경 | 3 | 합병, 분할, 분할합병 |
| 영업/자산 양수도 | 7 | 영업양수, 영업양도, 유형자산 양수/양도, 타법인 주식 취득/처분, 자산양수도(풋백옵션) |
| 자기주식 | 5 | 취득, 처분, 신탁 체결, 신탁 해지, 주식교환/이전 |
| 사채 | 7 | 전환사채, 신주인수권부사채, 교환사채, 조건부자본증권, 주식관련사채 양수/양도, 주식배당 |
| 해외상장 | 4 | 상장/폐지 결정, 상장/폐지 현황 |
| 법률/경영 | 6 | 채권은행관리 개시/중단, 채무불이행, 소송, 영업정지, 회생절차, 해산 |
증권신고서 (6개)
| Tool | 설명 |
|---|---|
opendart_equity_securities_reg |
지분증권 신고서 |
opendart_debt_securities_reg |
채무증권 신고서 |
opendart_depositary_receipts_reg |
예탁증권 신고서 |
opendart_merger_reg |
합병 신고서 |
opendart_stock_exchange_reg |
주식교환 신고서 |
opendart_division_reg |
분할 신고서 |
Usage Examples
Claude에서 다음과 같이 사용하세요:
- "삼성전자의 20XX년 재무제표를 보여줘"
- "SK하이닉스의 최신 최대주주 현황을 알려줘"
- "카카오의 최근 공시 10개를 검색해줘"
- "현대자동차의 20XX년 임원 보수 현황을 보여줘"
- "LG에너지솔루션에 전환사채 발행 결정이 있었는지 확인해줘"
Tech Stack
- Runtime: Next.js 16 + TypeScript
- MCP: mcp-handler + @modelcontextprotocol/sdk
- Deploy: Vercel (Streamable HTTP, Seoul region 권장)
- ZIP: fflate (corp code XML 압축 해제)
License
MIT
README mirrored from the source repository 2 hours ago. The original is authoritative.