Skip to main content
Glama
RealYoungk

OpenDART MCP Server

by RealYoungk

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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/RealYoungk/opendart-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server