dart-search-mcp
This server provides access to Korea's DART (Financial Supervisory Service Electronic Disclosure System) Open API, enabling corporate disclosure search and financial data retrieval.
Disclosure & Company Search
Search disclosures: Search DART filings by company name/code, date range, disclosure type, and market segment
Search company code: Look up a company's DART unique code by company name
Get company info: Retrieve company overview (CEO, address, industry, founding date, fiscal year end, etc.)
Financial Statements
Key financial statements: Get major accounts (revenue, operating profit, net income, assets, liabilities, equity) in a current/prior/two-years-ago comparison format
Full financial statements: Retrieve complete financials — balance sheet (BS), income statement (IS), comprehensive income (CIS), cash flow (CF), and changes in equity (SCE)
Multi-company financials: Compare key financial accounts across multiple companies simultaneously
Financial Indicators
Single company indicators: Get profitability (ROE, ROA, margins), stability (debt/current ratio), growth, and activity ratios
Multi-company indicators: Compare financial ratios across multiple companies at once
Equity & Shareholder Disclosures
Major shareholders report: View large shareholding (5%+) reports including ownership percentage and changes
Executive stock report: View executive and major shareholder (10%+) stock ownership and changes
Periodic & Event Reports
Periodic report: Access 27 types of regular report data (dividends, treasury stock, executive compensation, audit info, etc.)
Major event report: Access 36 types of major event disclosures (capital increases, mergers, splits, bond issuances, asset transfers, etc.)
Securities report: Access securities registration statements for equity, debt, depositary receipts, mergers, and more
Document Downloads & XBRL
Download document: Download original disclosure document ZIP files by filing/reception number
Download XBRL: Download XBRL financial statement ZIP files by company code and fiscal year
XBRL taxonomy: Look up standard account frameworks for various financial statement types
Allows searching corporate disclosures from the Korean DART (Financial Supervisory Service) system, including company information, financial statements, and disclosure filings.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@dart-search-mcpSearch disclosures for Samsung Electronics from 2024"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
dart-search-mcp
한국 금융감독원 전자공시시스템(DART) Open API를 MCP 서버와 CLI로 사용할 수 있게 해주는 도구입니다.
공시 검색, 기업 개황, 재무제표, 재무지표, 지분공시, 정기보고서 주요정보, 주요사항보고서, 증권신고서, 원문 ZIP, XBRL ZIP 다운로드를 지원합니다.
빠른 시작
DART Open API 키를 발급합니다.
환경 변수를 설정합니다.
export DART_API_KEY="your_api_key_here"의존성을 설치합니다.
uv sync로컬 상태를 점검합니다.
uv run dart diagnostics정상적으로 로드되면 Python 버전, 패키지 상태, API 키 설정 여부, MCP 도구 수, CLI 명령 수가 출력됩니다. API 키 값은 출력하지 않습니다.
Related MCP server: OpenDart-MCP
MCP 서버 실행
uv run dart serve또는 호환 엔트리포인트로 직접 실행할 수 있습니다.
uv run python server.pyMCP 클라이언트 설정 예시
Claude Desktop 등 MCP 클라이언트에는 이 저장소의 절대 경로를 넣어 연결합니다.
{
"mcpServers": {
"dart-search": {
"command": "uv",
"args": ["run", "python", "/absolute/path/to/dart-search-mcp/server.py"],
"env": {
"DART_API_KEY": "your_api_key_here"
}
}
}
}CLI 사용법
uv run dart search 삼성전자
uv run dart company 00126380
uv run dart disclosures --corp 삼성전자 --from 20240101 --to 20241231 --type A
uv run dart financial 00126380 2024
uv run dart financial-full 00126380 2024 --fs CFS
uv run dart indicators 00126380 2024 --class M210000
uv run dart multi-financial 00126380,00164779 2024
uv run dart shareholders 00126380
uv run dart periodic 00126380 2024 배당
uv run dart event 00126380 유상증자결정
uv run dart securities 00126380 지분증권전체 CLI 명령 목록은 docs/cli.md에 생성되어 있습니다.
XBRL 사용법
XBRL 재무제표 원본 ZIP은 download-xbrl 명령 또는 MCP 도구 download_xbrl로 내려받습니다.
uv run dart download-xbrl 00126380 2024 --report 11011 -o ./downloads보고서 코드는 다음 값을 사용합니다.
11011: 사업보고서11012: 반기보고서11013: 1분기보고서11014: 3분기보고서
접수번호를 알고 있으면 MCP 도구에서는 rcept_no를 직접 지정할 수 있습니다. 접수번호를 모르면 corp_code, bsns_year, reprt_code로 정기공시 목록에서 자동 조회합니다.
XBRL 표준계정과목체계는 다음처럼 조회합니다.
uv run dart taxonomy BS1지원 양식은 BS1, BS2, BS3, IS1, IS2, IS3, IS4, CIS1, CIS2, CIS3, CIS4, DC1, DC2입니다.
MCP 도구
현재 MCP 서버는 16개 도구를 제공합니다.
공시/기업:
search_disclosures,search_corp_code,get_company_info재무:
get_financial_statements,get_financial_statements_full,get_multi_company_financials지표:
get_financial_indicators,get_multi_company_indicators지분공시:
get_major_shareholders_report,get_executive_stock_report보고서 주요정보:
get_periodic_report,get_major_event_report,get_securities_report다운로드/XBRL:
download_document,download_xbrl,get_xbrl_taxonomy
전체 MCP 도구 목록은 docs/tools.md에 생성되어 있습니다.
개발 및 검증
문서를 현재 CLI/MCP 표면에서 다시 생성합니다.
uv run python scripts/generate_docs.py문서 drift를 포함한 로컬 QA를 실행합니다.
uv run python scripts/qa.py개별 테스트만 실행하려면 다음 명령을 사용합니다.
uv run python -m unittest discover -vMaintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/memorise8/dart-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server