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 Servers