Submit
RealYoungk

OpenDART MCP Server

Community RealYoungk
Updated

OpenDART MCP Server

금융감독원 DART 전자공시시스템 Open API를 MCP(Model Context Protocol) 서버로 제공합니다.

Claude, ChatGPT 등 MCP를 지원하는 AI 클라이언트에서 한국 상장기업의 공시정보, 재무제표, 지분공시 등 83개 API를 자연어로 조회할 수 있습니다.

사전 준비

OpenDART에서 API 인증키를 발급받으세요.

설치 및 설정

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "opendart": {
      "command": "uvx",
      "args": ["opendart-mcp"],
      "env": {
        "OPENDART_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

설정 파일 위치: macOS ~/Library/Application Support/Claude/claude_desktop_config.json

Claude Code

claude mcp add opendart -- uvx opendart-mcp

# API 키 설정
export OPENDART_API_KEY="<YOUR_API_KEY>"

Cursor / Windsurf

MCP 설정 파일(.cursor/mcp.json 또는 .windsurf/mcp.json)에 추가:

{
  "mcpServers": {
    "opendart": {
      "command": "uvx",
      "args": ["opendart-mcp"],
      "env": {
        "OPENDART_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

SSE (원격 서버)

uvx opendart-mcp --transport sse --host 0.0.0.0 --port 8000

Docker

docker build -t opendart-mcp .
docker run -e OPENDART_API_KEY="<YOUR_API_KEY>" -p 8000:8000 opendart-mcp

제공 도구 (83개)

공시정보 (4개)

도구 설명
search_disclosure 공시 검색 (기업코드, 날짜, 공시유형 등으로 필터링)
get_company_info 기업 개황 조회
get_document 공시 원문 다운로드 (ZIP)
get_corp_code 전체 고유번호 목록 다운로드

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

도구 설명
get_stock_issuance_status 증자(감자) 현황
get_dividend_info 배당에 관한 사항
get_treasury_stock_status 자기주식 취득 및 처분 현황
get_largest_shareholder 최대주주 현황
get_largest_shareholder_change 최대주주 변동 현황
get_minority_shareholder 소액주주 현황
get_executive_status 임원 현황
get_employee_status 직원 현황
get_individual_compensation 개인별 보수지급 금액 (5억 이상)
get_total_compensation 이사·감사 전체의 보수현황
get_top5_compensation 개인별 보수지급 금액 (상위 5인)
get_investment_in_others 타법인 출자 현황
get_total_shares_status 주식 총수 현황
get_debt_securities_issued 채무증권 발행실적
get_commercial_paper_balance 기업어음증권 미상환 잔액
get_short_term_bond_balance 단기사채 미상환 잔액
get_corporate_bond_balance 회사채 미상환 잔액
get_new_capital_securities_balance 신종자본증권 미상환 잔액
get_contingent_capital_balance 조건부자본증권 미상환 잔액
get_auditor_opinion 회계감사인의 감사의견
get_audit_service_contract 감사용역 체결현황
get_non_audit_service_contract 비감사용역 체결현황
get_outside_director_status 사외이사 및 그 변동현황
get_unregistered_exec_compensation 미등기임원 보수현황
get_total_compensation_approval 이사·감사의 보수한도 승인현황
get_compensation_by_type 유형별 보수지급 금액
get_public_offering_fund_usage 공모자금의 사용내역
get_private_placement_fund_usage 사모자금의 사용내역

재무정보 (7개)

도구 설명
get_single_company_accounts 단일회사 주요계정
get_multi_company_accounts 다중회사 주요계정
get_xbrl_document 재무제표 원본파일 (XBRL ZIP)
get_full_financial_statement 단일회사 전체 재무제표
get_xbrl_taxonomy XBRL 택사노미 재무제표 양식
get_single_financial_index 단일회사 주요 재무지표
get_multi_financial_index 다중회사 주요 재무지표

지분공시 (2개)

도구 설명
get_major_stockholding 대량보유 상황보고
get_executive_stockholding 임원·주요주주 소유보고

주요사항보고서 (36개)

도구 설명
get_asset_transfer_putback 자산양수도(풋백옵션)
get_default_occurrence 채무불이행(파산)
get_business_suspension 영업정지
get_rehabilitation_filing 회생절차 개시신청
get_dissolution_event 해산사유 발생
get_paid_capital_increase 유상증자 결정
get_free_capital_increase 무상증자 결정
get_mixed_capital_increase 유무상증자 결정
get_capital_reduction 감자 결정
get_creditor_management_start 채권은행 관리절차 개시
get_lawsuit_filing 소송 등의 제기
get_overseas_listing_decision 해외 상장 결정
get_overseas_delisting_decision 해외 상장폐지 결정
get_overseas_listing 해외 상장
get_overseas_delisting 해외 상장폐지
get_convertible_bond_decision 전환사채권 발행결정
get_bond_with_warrant_decision 신주인수권부사채권 발행결정
get_exchangeable_bond_decision 교환사채권 발행결정
get_creditor_management_stop 채권은행 관리절차 중단
get_contingent_bond_decision 조건부자본증권 발행결정
get_treasury_stock_acquisition_decision 자기주식 취득 결정
get_treasury_stock_disposal_decision 자기주식 처분 결정
get_treasury_trust_contract_decision 자기주식취득 신탁계약 체결 결정
get_treasury_trust_termination_decision 자기주식취득 신탁계약 해지 결정
get_business_acquisition_decision 영업양수 결정
get_business_transfer_decision 영업양도 결정
get_tangible_asset_acquisition_decision 유형자산 양수 결정
get_tangible_asset_transfer_decision 유형자산 양도 결정
get_other_corp_stock_acquisition_decision 타법인 주식 양수 결정
get_other_corp_stock_transfer_decision 타법인 주식 양도 결정
get_stock_bond_acquisition_decision 주권 관련 사채권 양수 결정
get_stock_bond_transfer_decision 주권 관련 사채권 양도 결정
get_merger_decision 회사합병 결정
get_division_decision 회사분할 결정
get_division_merger_decision 회사분할합병 결정
get_stock_exchange_transfer_decision 주식교환·이전 결정

증권신고서 (6개)

도구 설명
get_equity_securities_reg 지분증권
get_debt_securities_reg 채무증권
get_depositary_receipts_reg 증권예탁증권
get_merger_reg 합병
get_stock_exchange_reg 주식의 포괄적 교환·이전
get_division_reg 분할

주요 파라미터

파라미터 설명 예시
corp_code 기업 고유번호 (8자리) 00126380 (삼성전자)
bsns_year 사업연도 2024
reprt_code 보고서 코드 11013 1분기, 11012 반기, 11014 3분기, 11011 사업보고서
bgn_de / end_de 조회 시작일 / 종료일 (YYYYMMDD) 20240101 / 20241231
rcept_no 접수번호 (14자리) 20240312000736

corp_code를 모를 경우 search_disclosure로 기업명 검색하거나 get_corp_code로 전체 목록을 조회할 수 있습니다.

사용 예시

MCP 클라이언트(Claude 등)에서 자연어로 질문하면 됩니다:

  • "삼성전자 2024년 사업보고서에서 배당 정보 알려줘"
  • "네이버 최대주주 현황 조회해줘"
  • "2024년 삼성전자 자기주식 취득 결정 내역 보여줘"
  • "SK하이닉스 2024년 재무제표 주요계정 조회"
  • "카카오 임원 현황이랑 보수 정보 알려줘"

라이선스

MIT

MCP Server · Populars

MCP Server · New