MyDART
REMOTE · MYDART.EOCPA.KR · SCANNED AUG 18
Powerful OpenDART API-based Korean corporate disclosure tools for accounting professionals
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →
Endpoint Security74
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one. See how to fix → View diagnostics → Partial
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability58
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 15348 tokens (~959/item across 16 items; 16 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management17
- Stability observed for 5 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
remote · mydart.eocpa.kr
claude mcp add --transport http kr-eocpa-mydart https://mydart.eocpa.kr/mcp
[mcp_servers.kr-eocpa-mydart] url = "https://mydart.eocpa.kr/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"kr-eocpa-mydart": {
"type": "remote",
"url": "https://mydart.eocpa.kr/mcp",
"enabled": true
}
}
} openclaw mcp add kr-eocpa-mydart --url https://mydart.eocpa.kr/mcp --transport streamable-http
mcp_servers:
kr-eocpa-mydart:
url: "https://mydart.eocpa.kr/mcp" {
"mcpServers": {
"kr-eocpa-mydart": {
"type": "http",
"url": "https://mydart.eocpa.kr/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 18 Aug 26 +1
- The server rewrote its instructions, which are the text every model session reads security
- 17 Aug 26 0
- The server rewrote its instructions, which are the text every model session reads security
- 16 Aug 26 +1
- The server rewrote its instructions, which are the text every model session reads security
- 15 Aug 26 0
- The server rewrote its instructions, which are the text every model session reads security
- 14 Aug 26 +1
- The server rewrote its instructions, which are the text every model session reads security
- Tool “download_document” rewrote its description, which is the text the model reads security
- Tool “find_corp_code” rewrote its description, which is the text the model reads security
- Tool “get_attachments” rewrote its description, which is the text the model reads security
- Tool “get_audit_profile” rewrote its description, which is the text the model reads security
- Tool “get_audit_report” rewrote its description, which is the text the model reads security
- Tool “get_company_profile” rewrote its description, which is the text the model reads security
- Tool “get_corporate_event” rewrote its description, which is the text the model reads security
- Tool “get_financials” rewrote its description, which is the text the model reads security
- Tool “get_going_concern” rewrote its description, which is the text the model reads security
- Tool “get_internal_control” rewrote its description, which is the text the model reads security
- Tool “get_periodic_report” rewrote its description, which is the text the model reads security
- Tool “get_valuation_data” rewrote its description, which is the text the model reads security
- Tool “get_xbrl” rewrote its description, which is the text the model reads security
- Tool “search_audit_findings” rewrote its description, which is the text the model reads security
- Tool “search_disclosures” rewrote its description, which is the text the model reads security
- Schema quality: 1194 → 959 ▲ functional
- Stability: unverified → 0.03 ▲ functional
- Server version: 0.18.10 → 0.18.12 functional
- Server version: 0.18.9 → 0.18.10 functional
- Server version: 0.18.8 → 0.18.9 functional
- “download_document” reworded the description of “doc_index” cosmetic
- “download_document” reworded the description of “format” cosmetic
- “download_document” reworded the description of “truncate_at” cosmetic
- “find_corp_code” reworded the description of “limit” cosmetic
- “get_attachments” reworded the description of “dcm_no” cosmetic
- “get_attachments” reworded the description of “filename” cosmetic
- “get_attachments” reworded the description of “min_dimension” cosmetic
- “get_attachments” reworded the description of “mode” cosmetic
- “get_attachments” reworded the description of “pages” cosmetic
- “get_attachments” reworded the description of “zip_index” cosmetic
- “get_audit_profile” reworded the description of “light” cosmetic
- “get_audit_report” reworded the description of “corp” cosmetic
- “get_audit_report” reworded the description of “fs_div” cosmetic
- “get_audit_report” reworded the description of “rcept_no” cosmetic
- “get_audit_report” reworded the description of “truncate_at” cosmetic
- “get_company_profile” reworded the description of “year” cosmetic
- “get_corporate_event” reworded the description of “event_types” cosmetic
- “get_corporate_event” reworded the description of “limit” cosmetic
- “get_corporate_event” reworded the description of “mode” cosmetic
- “get_corporate_event” reworded the description of “start” cosmetic
- “get_financials” reworded the description of “corps” cosmetic
- “get_financials” reworded the description of “fs_div” cosmetic
- “get_going_concern” reworded the description of “fs_div” cosmetic
- “get_internal_control” reworded the description of “fs_div” cosmetic
- “get_periodic_report” reworded the description of “max_items” cosmetic
- “get_periodic_report” reworded the description of “report_type” cosmetic
- “get_periodic_report” reworded the description of “year” cosmetic
- “get_valuation_data” reworded the description of “corp” cosmetic
- “get_valuation_data” reworded the description of “freq” cosmetic
- “get_valuation_data” reworded the description of “kind” cosmetic
- “get_xbrl” reworded the description of “format” cosmetic
- “get_xbrl” reworded the description of “fs_div” cosmetic
- “search_audit_findings” reworded the description of “fs_div” cosmetic
- “search_audit_findings” reworded the description of “limit” cosmetic
- “search_disclosures” reworded the description of “concurrency” cosmetic
- “search_disclosures” reworded the description of “corp” cosmetic
- “search_disclosures” reworded the description of “limit” cosmetic
- “search_disclosures” reworded the description of “page” cosmetic
- “search_disclosures” reworded the description of “start” cosmetic
- 13 Aug 26 66
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 18 Aug 2026 · Probed https://mydart.eocpa.kr/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=mydart.eocpa.kr | CN=YE1,O=Let's Encrypt,C=US | 5 Jul 2026 | 3 Oct 2026 | ECDSA 256 | ECDSA-SHA384 | 58127712226b403bc69f82203e2e6864d14 |
| SANs: mydart.eocpa.kr | ||||||
| CN=YE1,O=Let's Encrypt,C=US (CA) | CN=Root YE,O=ISRG,C=US | 3 Sept 2025 | 2 Sept 2028 | ECDSA 384 | ECDSA-SHA384 | 5ddd70dd31f801c85c186a7a04b80afe |
| CN=Root YE,O=ISRG,C=US (CA) | CN=ISRG Root X2,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | ECDSA-SHA384 | 872165fc34b6e5fba8add5b3705fb53a |
| CN=ISRG Root X2,O=Internet Security Research Group,C=US (CA) | CN=ISRG Root X1,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | SHA256-RSA | 6c8f1dc727c7117f7baf853ac980f9cd |
DNSSEC insecure
Validation of mydart.eocpa.kr. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| kr. | present | 61615 | 8 | Verified |
| eocpa.kr. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
| Header | Value |
|---|---|
| x-content-type-options | nosniff |
| x-frame-options | DENY |
| referrer-policy | strict-origin-when-cross-origin |
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://mydart.eocpa.kr/mcp | Verified | 200 | |
| http (plaintext) | http://mydart.eocpa.kr/mcp | HTTPS enforced | 301 | https://mydart.eocpa.kr/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
download_document ~650
MyDART MCP의 download_document 도구는 공시 원문 본문을 마크다운으로 읽습니다(heading·표 구조 보존). 사업보고서 ZIP 안의 감사보고서 선택 포함. [Purpose] - 공시 텍스트 전문이 필요할 때. 감사의견·KAM 등 감사 내용의 "분석"은 get_audit_report 가 더 적합합니다. - 비상장 미제출사의 재무제표·주석은 F 감사보고서 rcept 를 이 도구로 여는 것이 정식 경로입니다. - 본문이 아니라 HWP·PDF 첨부나 형제문서(정관·영업보고서·내부회계 운영실태보고서)가 목적이면 get_attachments 로, 재무수치를 XBRL 로 받으려면 get_xbrl 로 갑니다. [Usage] 1. "이 사업보고서 원문 읽어줘" → rcept_no="20260310002820" 2. "연결 감사보고서 본문" → check documents[] for role=consolidated_audit, then doc_index=that index 3. "본문이 잘렸어, 전체로" → rcept_no="…", truncate_at=2000000 [Response] - role: main_body / separate_audit(별도 감사보고서) / consolidated_audit(연결) / internal_control / other - documents[]: metadata only — it carries content ONLY with all_docs=true [Rules] - A 사업보고서 ZIP holds MULTIPLE documents — 감사의견·KAM·내부회계 live in the 별도(_00760)/연결(_00761) sub-docs, not in index 0. Check documents[].role first, then re-call with doc_index (or all_docs=true). - If truncated=true, compare char_count and raise truncate_at.
| Name | Type | Req | Description |
|---|---|---|---|
| all_docs | boolean | – | Convert every 원문 XML in the ZIP and return them as documents[] — the 사업보고서 본문 plus 별도/연결 감사보고서 in one call. |
| doc_index | integer | – | Selects one 원문 XML inside the ZIP (0-based; 0=본문 when omitted). Use the index from the documents list. The 감사보고서 body is usually index 1~2 (별도/연결). An out-of-range value silently falls back to the ma… |
| format | string | – | Output format. markdown=DART XML → 마크다운, raw=original XML, text=tags stripped (table structure is lost) |
| rcept_no | string | yes | 14-digit 접수번호 (the rcept_no from search_disclosures). Hyphens and spaces are stripped. |
| truncate_at | integer | – | Max text length (the excess is cut). Default 300,000 chars; out-of-range values are clamped to the bound. With all_docs=true the budget is divided across the documents (the per-document share comes b… |
No output schema declared.
No examples provided.
find_corp_code ~405
MyDART MCP의 find_corp_code 도구는 회사명·종목코드로 DART 법인 식별자(corp_code)의 후보를 확인합니다. [Purpose] - 중요: corp_code 를 모르는 기업 조회 시 이 도구를 먼저 사용합니다. - 같은 이름의 회사가 여럿이라 어느 법인인지 모호할 때 후보 확인에도 사용합니다. - 식별자 확인 전용이라, 업종·데이터 위치까지 봐야 하면 get_company_profile, 기간·유형별 공시 목록이 필요하면 search_disclosures 로 넘어갑니다. [Usage] 1. "카카오" → corp_code 획득 → 재무제표 조회(get_financials) 2. "삼성전자" → corp_code 획득 → 임원 현황 조회(get_periodic_report) 3. "'동양' 들어가는 회사 후보 보여줘" → query="동양", limit=20 4. "005930이 어느 회사야?" → query="005930" [Response] - stock_code: 6-digit present = listed (common shares); empty/absent = unlisted. - count = rows returned (capped by `limit`), not the total match count. 0 hits adds a `hint`. [Rules] - `results` is a similarity-ranked candidate array — do not assume the first item is the answer. - corp_code identifies the DART LEGAL ENTITY CODE, not the listing ticker. 우선주/ETF/ETN codes have no mapping (보통주 codes only). - Common names may overflow the default `limit` — raise it when candidates look truncated.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Max candidates to return (default 10, max 50) |
| query | string | yes | 회사명 (한/영), 6-digit 종목코드, or 8-digit corp_code |
No output schema declared.
No examples provided.
get_attachments ~1,280
MyDART MCP의 get_attachments 도구는 공시의 첨부파일(HWP/PDF/DOCX/XLSX)과 형제문서를 목록·추출·이미지로 다룹니다. [Purpose] - 첨부 원본용. 본문 텍스트는 download_document 가 구조 보존이 낫습니다. - 자금부정통제(「횡령 등 자금 부정위험 대응 내부통제 활동」) 붙임·경영진 운영실태보고서가 이 도구 몫입니다(mode=text=본문·표, 붙임=attachment_links[].retrieve). - 스캔으로만 있는 내용(스캔 서식·도장·서명)은 mode=images 가 유일한 경로입니다. [Usage] 1. 정관·영업보고서·운영실태보고서 본문 → list 로 dcm_no 확보 → dcm_no, mode="text" [Response] - format: hwpx/hwp/pdf/docx/doc/xlsx/xls/zip/html/unknown - text_quality: PDF 전용 — 타 포맷은 null(품질 문제 아니라 미해당) [Rules] - supported:false 면 unsupported_reason·suggestion·note·retrieve·next_step 이 완성형 대체 경로다 — 인자 추측 없이 그대로 따른다. - 여러 공시 연속 순회 금지 — 뷰어 대량 호출은 DART IP 차단을 부른다. - markdown 신뢰는 needs_ocr 하나가 아니라 계층으로: ① is_image_based·char_count 0=진성 스캔, images 만이 경로. ② high_pua 등 비-low_text=글자 깨짐이라 markdown 이 차 있어도 오류 가능, images 로 대조. ③ low_text 단독인데 markdown 이 실하면 markdown 이 정본(서버가 오탐 자동 기각), 빈약하면 ocr_candidate_pages 로 images. ④ needs_ocr=false 여도 image_only_pages 확인 — 도장·서명·스캔 표(자금부정통제 서식)가 그 페이지에만 이미지로 있다.
| Name | Type | Req | Description |
|---|---|---|---|
| dcm_no | string | – | Target 문서번호(dcmNo). Defaults to the 본문 document. One 공시(rcept_no) carries, besides the 본문, sibling documents (감사보고서·내부회계관리제도운영보고서·영업보고서·정관 etc.) each with its own dcmNo; take sibling_documents[].dcm_… |
| filename | string | – | Exact filename, in extract mode (no partial-match fallback). An EXACT match is required; on failure the error lists the available names. |
| index | integer | – | 0-based index, in extract mode (filename takes precedence) |
| max_images | integer | – | Max images returned in images mode (largest area first). Default 12. |
| min_dimension | integer | – | In images mode, an image whose shorter side is under this many pixels is treated as decoration (아이콘·괘선) and dropped. Default 24. Lower it to catch small 도장/서명. It filters the PDF-scan path only (sour… |
| mode | string | – | list: the attachment list only — nothing is downloaded, so it is the cheap call. text: the document body as 마크다운 via the 뷰어 원문 (XML→HTML) path — it skips PDF conversion, so text and tables are lossle… |
| outline_max_items | integer | – | Max outline(목차) entries. A 사업보고서 outline runs to thousands → default 50. 0 = omit the outline. |
| pages | string | – | Page filter for images mode (1-based, PDF-scan path only). e.g. "3", "1-5", "2,4,7-9". When given, a PDF is fetched instead of the 뷰어 JPEG and those pages are scanned (pass the value text_quality.nex… |
| rcept_no | string | yes | 14-digit 접수번호 (separators are stripped automatically) |
| truncate_at | integer | – | Max length of the extract 마크다운 (default 100,000 chars; out-of-range values are clamped to the bound) |
| zip_index | integer | – | Index of the file inside a ZIP attachment when extracting (0-based) — that inner file is the one parsed into 마크다운. If unset and the attachment is a ZIP, only the inner file list is returned. Use entr… |
No output schema declared.
No examples provided.
get_audit_profile ~914
MyDART MCP의 get_audit_profile 도구는 감사인·감사의견·업무수행이사에 감사보수·감사투입시간·실사수행내역·외부조회 실시여부 등 외부감사 실시내역을 한 표로 요약해 반환합니다. [Purpose] - "누가 얼마에 감사했고, 실사는 어땠나" 같은 사실·수치 질문에 최적입니다. - 강조사항은 emphasis 로 이미 정형화돼 있습니다 — 의견근거·KAM·강조 문단 원문 전문이 필요할 때만 get_audit_report. - 내부회계관리제도(ICFR) 세부 판정은 get_internal_control, 계속기업 정량 점검은 get_going_concern. - 조건에 맞는 회사 목록(모집단)은 search_audit_findings. [Usage] 1. "삼성전자 2024 감사보수·비감사보수" → corp="삼성전자", year=2024 2. "재고실사 입회했는지 빠르게만" → corp="…", year=2024, light=true [Response] - fees `_m` suffix = 백만원. - opinion domain: 적정/한정/부적정/의견거절. [Rules] - data_available=false = the filing was not found (e.g. not yet filed) — do NOT read null fields as "confirmed absent". - audit_only=true (F 단독공시, unlisted) → fees are structurally absent (사업보고서 전용), not a defect. - For 연결/별도 split read kam.by_fs_div, not kam.topics (representative fallback). - ALWAYS read applicability.guidance[] — regime notes and next-tool routing. - 감사인 교체/연속연수 are NOT returned — call per year and compare auditor.name.
| Name | Type | Req | Description |
|---|---|---|---|
| corp | string | yes | 회사명/종목코드/corp_code |
| light | boolean | – | Skip 원문 parsing (structured JSON APIs only — omits 실사, the fs_div split, and fees.headcount, which comes from the 실사 source; fast) |
| refresh | boolean | – | Bypass the cache and re-collect |
| year | integer | yes | 결산 사업연도 (회계연도, fiscal year) — the number you pass IS the 사업연도=회계연도=결산연도. Do NOT subtract it; pass it as-is. Only tools where year is optional auto-select the latest published year when omitted (if ye… |
No output schema declared.
No examples provided.
get_audit_report ~1,084
MyDART MCP의 get_audit_report 도구는 감사보고서 본문을 문단 단위로 구조화해 문단별 원문 텍스트를 반환합니다 — 감사의견·감사의견근거·KAM·강조사항·기타사항·계속기업가정불확실성. [Purpose] - 감사보고서 서술 문단의 원문이 필요할 때. 보수·실사 등 정형 사실 요약은 get_audit_profile 입니다. - 내부회계관리제도(ICFR) 세부와 재무제표 감사의견과의 정합 확인은 get_internal_control 이 담당합니다. [Usage] 1. "LG에너지솔루션 2024 KAM 문단 전문" → corp="LG에너지솔루션", year=2024 2. "삼부토건 FY2024 별도 의견거절 근거 원문" → corp="삼부토건", year=2024, fs_div="OFS" 3. "강조사항이 잘렸어, 전체로" → corp="…", year=…, truncate_at=50000 [Response] - sections[].key: opinion / basis / going_concern / kam / emphasis / other_matter / mgmt_resp / auditor_resp … (KSA700 elements). opinion: 적정/한정/부적정/의견거절. - fs_label: 연결/별도. source_note = F 단독공시 출처, correction_note = 정정공시 채택/생략. [Rules] - Interpret kam.count=0 together with none_declared: declared "없음" = normal; undeclared = suspect omission. - Unlisted (F 단독공시) legitimately lacks KAM·업무수행이사 paragraphs (see source_note). - 재무제표·주석 FIGURES are not here — use download_document.
| Name | Type | Req | Description |
|---|---|---|---|
| corp | string | – | 회사명/종목코드/corp_code (required when rcept_no is absent). corp+year auto-locates the 사업보고서, falling back to the 감사보고서 F 단독공시 for unlisted companies; results on that path are cached |
| fs_div | string | – | both (default — 연결+별도 both)/연결(CFS)/별도(OFS). Aliases consolidated/separate·연결/별도 also accepted. With both, reports[] holds 2 entries — reading only the first drops an axis. |
| rcept_no | string | – | 접수번호 given directly (instead of corp/year) — parses that filing live (never cached) and returns resolved/applicability as null. A 감사보고서제출(F) 단독공시 works too. |
| refresh | boolean | – | Bypass the cache and re-collect (corp+year path only) |
| truncate_at | integer | – | Max length per section body (default 8,000 chars; the excess is cut, out-of-range values are clamped to the bound). On truncated=true check char_count and re-call with a higher value |
| year | integer | – | 결산 사업연도 (회계연도, fiscal year) — the number you pass IS the 사업연도=회계연도=결산연도. Do NOT subtract it; pass it as-is. Only tools where year is optional auto-select the latest published year when omitted (if ye… |
No output schema declared.
No examples provided.
get_company_profile ~525
MyDART MCP의 get_company_profile 도구는 기업개황(업종·대표자·결산월·상장구분)과 데이터 위치(data_location)를 조회합니다. [Purpose] - 회사 기본 정보와, 낯선 회사(특히 비상장)에 재무·감사 도구를 부르기 전 라우팅 확인용 첫 호출. - 감사인·감사의견·감사보수는 get_audit_profile, 회사 지정이 모호해 후보부터 골라야 하면 find_corp_code. [Usage] 1. "카카오는 뭐 하는 회사야?" → corp="카카오" 2. "교보생명 FY2024 재무는 어디서 봐?" → corp="교보생명", year=2024 3. "종목코드 068270 기업 개황" → corp="068270" [Response] - data_location.filing_tier: listed(financials=JSON API) / listed_konex(NOT in structured financial APIs — financials live in 사업보고서 원문) / unlisted_reporting / audit_only(financials+notes live in 감사보고서 F 단독공시 원문) / no_disclosure_found / unknown - company.corp_cls: Y=코스피/K=코스닥/N=코넥스/E=기타(비상장). acc_mt = 결산월. [Rules] - Route follow-up calls by data_location: audit_only → get_financials returns [013], open f_separate_rcept via download_document instead. listed_konex → empty get_financials/get_xbrl is NORMAL, do not retry. - provisional=true (year omitted) is tentative — never conclude 비외감 from no_disclosure_found.
| Name | Type | Req | Description |
|---|---|---|---|
| corp | string | yes | 회사명/종목코드/corp_code |
| year | integer | – | 회계연도 that applicability.data_location (where 재무·감사 data lives) is judged against. Defaults to the latest (marked 잠정). Matters only for 비상장사 — a 상장사 is always 사업보고서(JSON), so it is reported as listed… |
No output schema declared.
No examples provided.
get_corporate_event ~767
MyDART MCP의 get_corporate_event 도구는 주요사항보고서 자본·지배구조 이벤트 36종(증자·감자·CB/BW/EB·자기주식·합병/분할 등)과 5%룰·임원 지분공시를 조회합니다. [Purpose] - 특정 이벤트 상세(single), 또는 최근 N년 자본 변동 흐름의 통합 연대기(timeline)가 필요할 때. - "누가 언제 지분을 늘리고 줄였나"는 event_types="holdings"(5%룰 대량보유·임원/주요주주 소유보고). - 공시 목록 훑기는 search_disclosures, 최대주주·주식총수 등 사업보고서 시점 스냅샷은 get_periodic_report 로. [Usage] 1. "카카오 최근 3년 자본 조달 흐름" → corp="카카오", mode="timeline" 2. "이 회사 CB 발행한 적 있어?" → corp="…", mode="single", event_type="cb_issuance" 3. "삼성전자 자사주 취득·처분 2020년부터" → corp="삼성전자", mode="timeline", event_types=["treasury_acquisition","treasury_disposal","treasury_trust_contract","treasury_trust_cancel"], start="2020-01-01" [Response] - date = filing date (rcept_dt); 실제 이벤트일(이사회 결의일 등)은 raw row 필드에 있다. - 지분공시 섹션은 total_count=**전 기간 누적**, filtered_count=기간 내 건수다(DART 가 기간을 안 받아 전량 수신 후 거른다). [Rules] - 빈 timeline ≠ 이벤트 없음 — 기본 집합은 자본거래뿐이고(그 외는 event_types 명시), sections_meta 에 엔드포인트별 오류가 있을 수 있다. - event_type_counts 는 절단 전 전체 기준(timeline 만 limit 로 잘린다).
| Name | Type | Req | Description |
|---|---|---|---|
| corp | string | yes | 회사명/종목코드/corp_code |
| end | string | – | End date (YYYY-MM-DD / YYYYMMDD). Defaults to today |
| event_type | string | – | REQUIRED in single mode. One of the 38 selectable events (36 주요사항 + 지분공시 2종) |
| event_types | array | – | Manual selection for timeline mode — passing this switches mode to timeline automatically. When unset, every 자본 관련 event (capital=true) is selected; 소송·부도·회생·해외상장·지분공시 are NOT in that default set, so… |
| limit | integer | – | Cap on timeline rows returned (default 100, date descending). The excess is cut and flagged via truncated=true, with total_events carrying the real count — a company with frequent 자본거래 yields hundred… |
| mode | string | – | single: query one event_type. timeline: query the 자본 관련 events in parallel (25 types by default) and merge them into one date-descending list |
| start | string | – | Start date (YYYY-MM-DD / YYYYMMDD). Defaults to 3 years ago — an omitted bound is flagged as period.defaulted:true in the response |
No output schema declared.
No examples provided.
get_financials ~889
MyDART MCP의 get_financials 도구는 매출·영업이익·순이익·자산/부채/자본 등 재무수치를 조회합니다 — 재무 질문 대부분은 이걸로 충분합니다. [Purpose] - 재무제표 숫자의 첫 선택. 계산(합산)검증·주석 XBRL·원본 파일이 필요할 때만 get_xbrl. - 사업보고서 서술이 필요하면 get_periodic_report, 부실징후(계속기업) 판정은 get_going_concern. [Usage] 1. "삼성전자 2025년 매출·영업이익" → corps=["삼성전자"], year=2025 2. "삼성전자와 SK하이닉스 실적 비교" → corps=["삼성전자","SK하이닉스"] 3. "LG화학 FY2024 전체 재무제표, 별도, 현금흐름표 포함" → corps=["LG화학"], year=2024, scope="full", fs_div="OFS", sj_div=["BS","IS","CIS","CF"] [Response] - Row keys: sj_div, account_nm, thstrm_amount(당기)/frmtrm_*(전기)/ bfefrmtrm_*(전전기)/thstrm_add_amount(누계). Amounts are STRINGS. - full: total_count=pre-filter, count=post-filter. [Rules] - Quarterly/half IS·CIS·CF rows: CUMULATIVE = thstrm_add_amount, thstrm_amount = that quarter alone (half-value trap — period_basis explains). BS rows: thstrm_amount only. - Cross-check the periods legend (전기/당기 off-by-one) and year_defaulted. - no_data is routing, not an error — follow next_step (retry is futile for audit_only/listed_konex).
| Name | Type | Req | Description |
|---|---|---|---|
| corps | array | yes | Array of companies. With scope=summary: 1 (single) or 2+ (multi-company comparison). scope=full takes EXACTLY 1 — give 2 or more and only the first is returned, the rest are dropped (there is no mult… |
| fs_div | string | – | With scope=full, selects 연결(CFS)/별도(OFS) (default CFS). The response echoes the basis ACTUALLY used, not the requested one — a CFS→OFS auto-fallback is flagged by fs_div_note. Ignored by scope=summar… |
| report | string | – | q1/half/q3/annual |
| scope | string | – | summary: 주요계정, 8~10 rows (fast). full: the whole 재무제표 (BS/IS/CF/CIS/SCE), hundreds~1k rows |
| sj_div | array | – | With scope=full, filters 재무제표 종류 (when unset: BS+IS+CIS — a company using the '단일 포괄손익계산서' presentation reports 손익 in CIS only, not IS, so CIS is included by default). BS=재무상태표, IS=손익계산서, CF=현금흐름표, C… |
| year | integer | – | 결산 사업연도 (회계연도). When omitted, the most recently PUBLISHED 사업연도 is selected automatically — this absorbs the validation error that used to occur when the caller left year out for a question that never… |
No output schema declared.
No examples provided.
get_going_concern ~881
MyDART MCP의 get_going_concern 도구는 계속기업가정 관련 위험을 정량 재무지표와 감사보고서 언급 여부의 교차로 판정합니다. [Purpose] - "계속기업 위험 있나", 특히 "수치는 위험한데 감사인 언급이 없는" 불일치를 짚을 때. - 조건별 회사 목록은 search_audit_findings. - 수치만 볼 땐 get_financials, 계속기업 문단 원문은 get_audit_report. [Usage] 1. "이스타코 2024 계속기업 위험 있어?" → corp="이스타코", year=2024 2. "별도 기준 정량 점검" → corp="…", year=2024, fs_div="OFS" [Response] - flags.consecutive_op_loss = NUMBER of 연속 영업손실 years (not a bool); others bool|null. - grade: 판정불가(no data)/양호(0)/주의(1~2)/경계(3~4)/위험(5+) - cross_check.code: both/quant_only/text_only/none/insufficient_data/quant_unavailable/report_unavailable [Rules] - NEVER read text.going_concern_mentioned null (report not secured = unknown) as false (checked, no mention). - quant_only covers TWO cases — risky figures with no mention confirmed, OR with report not secured; distinguish via going_concern_mentioned (false vs null). - grade "판정불가" is not "양호". flags null = account not secured, not false. - Response fs_div is post-fallback — a CFS request may return OFS.
| Name | Type | Req | Description |
|---|---|---|---|
| corp | string | yes | 회사명/종목코드/corp_code |
| fs_div | string | – | 연결(CFS)/별도(OFS), default CFS. Falls back to 별도 automatically when 연결 is absent (the response fs_div reports the basis actually used). Aliases consolidated/separate·연결/별도 also accepted. |
| refresh | boolean | – | Bypass the cache and re-collect |
| year | integer | yes | 결산 사업연도 (회계연도, fiscal year) — the number you pass IS the 사업연도=회계연도=결산연도. Do NOT subtract it; pass it as-is. Only tools where year is optional auto-select the latest published year when omitted (if ye… |
No output schema declared.
No examples provided.
get_internal_control ~1,013
MyDART MCP의 get_internal_control 도구는 '감사인'의 내부회계관리제도(ICFR) 감사/검토 보고서를 조회합니다 — 구분·의견·중요한 취약점 여부. [Purpose] - ICFR 의견·취약점을 재무제표 감사의견과 대조할 때. 취약점 보유 회사 목록은 search_audit_findings. - 자금부정통제(횡령 등 자금 부정 예방·적발)·경영진 「내부회계관리제도 운영실태보고서」는 감사인 ICFR 보고서에 없다 → get_attachments(사업보고서 rcept, mode=list→dcm_no→mode=text, 스캔은 images; rcept 없으면 search_disclosures preset='annual_report'). - 정형 감사 사실은 get_audit_profile, 본문 원문은 get_audit_report. [Usage] 1. "카카오페이 2024 내부회계 의견" → corp="카카오페이", year=2024 2. "연결 기준만" → corp="…", year=2024, fs_div="CFS" [Response] - opinion domain: 적정/부적정/의견거절 — NO '한정'. 검토(review_or_audit)의 의견거절 = 범위제한에 따른 검토결론 불표명. [Rules] - reports is an ARRAY — both gives up to 2 entries (연결·별도). - present=false is usually out-of-scope (read the note), not missing data; an empty CFS entry is normal. - Never conflate a review's 의견거절 with an audit's — check review_or_audit. - 자금부정통제(FY2025~ 의무, FY2024 선택)·시정계획은 경영진 운영실태보고서 소관 — see management_operation_report.steps (applicable=false = F 단독공시라 보고서 자체가 없음).
| Name | Type | Req | Description |
|---|---|---|---|
| corp | string | yes | 회사명/종목코드/corp_code |
| fs_div | string | – | both (default — 연결+별도 both)/연결(CFS)/별도(OFS). ICFR normally exists for 별도(OFS) only; 연결(CFS) ICFR 감사 applies only to 전기말 별도자산 2조↑ filers from FY2023. 별도(OFS) falls back to a standalone ICFR 공시 when th… |
| refresh | boolean | – | Bypass the cache and re-collect |
| year | integer | yes | 결산 사업연도 (회계연도, fiscal year) — the number you pass IS the 사업연도=회계연도=결산연도. Do NOT subtract it; pass it as-is. Only tools where year is optional auto-select the latest published year when omitted (if ye… |
No output schema declared.
No examples provided.
get_periodic_report ~812
MyDART MCP의 get_periodic_report 도구는 사업보고서 세부 섹션 28종을 정형 데이터로 조회합니다 — 한 섹션 또는 여러 섹션 동시. [Purpose] - 배당·자기주식·최대주주·소액주주·임원보수·회계감사인·회사채 미상환 등 섹션 표가 필요할 때. - 지배구조 스냅샷·임원 보수 전반은 묶음 별칭 한 번으로(shareholders·executive_compensation). - 재무제표 본체 수치는 get_financials 로. auditor_opinion 은 의견 한 단어뿐이라 KAM·내부회계·강조사항은 get_audit_profile / get_audit_report 로 갑니다. [Usage] 1. "삼성전자 2025년 배당 내역" → corp="삼성전자", year=2025, report_type="dividends" 2. "카카오 최대주주가 누구야" → corp="카카오", report_type="shareholders" (year 생략 = 최신) 3. "LG전자 임원 보수 전부" → corp="LG전자", report_type="executive_compensation" [Response] - Amounts are STRINGS. Section status: 000 성공 / 013 무자료. - periods legend maps 당기/전기/전전기 → fiscal years (기수 컬럼이 있는 섹션만). [Rules] - 비12월 결산이면 fiscal_year_note 를 그대로 인용할 것 — 감사 도구와 1년 어긋난다. - ARRAY 는 요소마다 status 가 다르다(성공·013·error 혼재) — 요소별로 확인한다. 전 섹션이 013 이면 { mode:"no_data", … } 복구 라우팅으로 바뀐다. - 상장사의 [013] 은 대개 실패가 아니라 "정당한 부재"다(배당·자기주식 없음, 개인별 보수는 해당자 없음). - Cite 당기/전기 only after checking the periods legend.
| Name | Type | Req | Description |
|---|---|---|---|
| corp | string | yes | 회사명/종목코드/corp_code |
| max_items | integer | – | Cap on rows returned per section (default 150). The excess is cut and flagged via truncated=true, and total_count then carries the real row count — this keeps responses from bloating on row-heavy, pr… |
| report | string | – | Report type |
| report_type | – | yes | 28 sections — **a single string OR an array** (an array is collected in parallel and returned as sections[]). Families: 주주 4 (largest_shareholder etc.) / 임직원 3 (executives etc.) / 보수 6 (executive_com… |
| year | integer | – | 결산 사업연도 (회계연도) — the FISCAL year, NOT the filing year. When omitted, the most recently PUBLISHED year is selected automatically, based on 결산월(acc_mt) and report type. Confirm the year actually used v… |
No output schema declared.
No examples provided.
get_usage_stats ~303
MyDART MCP의 get_usage_stats 도구는 도구 사용량 집계를 반환합니다 — 어떤 도구가 얼마나 쓰였는지. [Purpose] - 도구별 호출수·인기 순위·응답시간·에러율·캐시 적중과 일별 추이를 볼 때 쓰세요. [Usage] 1. "사용량 통계 보여줘" → {} (default 30 days) 2. "최근 90일 도구별 순위" → days=90 3. "전체 기간 누적" → days=0 [Response] - Common: { period, overview:{total_calls, unique_users, error_rate}, by_tool:[{tool, calls, errors, avg_ms, cache_hits, cache_hit_rate, share_pct}], by_day[] } - Operator identity (local stdio, or the HTTP key matching the server operator's) additionally gets by_company·users·viewer — decided by requester identity, NOT selectable by parameter. [Rules] - public responses have no by_company / per-user detail — do not promise them to general callers. - Local stdio may show total_calls>0 with unique_users=0 (single local user — not a contradiction). - error_rate is a 0~1 decimal; share_pct is a percentage — different units.
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | Trailing window in days. 0 = the entire retained period. |
No output schema declared.
No examples provided.
get_valuation_data ~1,458
MyDART MCP의 get_valuation_data 도구는 가치평가 데이터(시장 시계열·WACC·유사회사)를 kind 로 골라 조회합니다. [Purpose] - 평가기준일 시세·β 검산, 자본비용(WACC) 산출, 상대가치 피어 비교에 씁니다. - 근거 제시가 목적이고 채택은 평가자 판단 — 전 구성요소 오버라이드 가능. - 재무수치는 get_financials, 업종(KSIC)·시장구분은 get_company_profile. [Usage] 1. "에스에프에이 최근 1년 주가" → kind="market", corp="에스에프에이" 2. "반도체장비 업종 피어 멀티플" → kind="peers", ksic="29271" [Response] - Units: *_pct = annual %, but mrp·srp·tax_rate = decimals (0.08 = 8%); close = 무수정주가, flt_rt = 등락률 %. - wacc_pct is null when 신용등급 미공시 while 차입 exists — nothing is assumed. [Rules] - Compute market returns from flt_rt, never by differencing close (breaks at 액면분할·병합). - aggregates n differs per metric (EBITDA often missing) — never quote a mean without n. - peers is a KSIC candidate list the 평가자 curates; too few peers relax the prefix 5→4→3 — prefix_depth_used shows 업종 동질성 dilution. - Cite the response's source·as_of verbatim (조서 정합) — 금투협 시가평가·한공회 가이던스·ECOS·금융위 시세. - ALWAYS read notes[] — 강등·폴백·주의 accumulate there.
| Name | Type | Req | Description |
|---|---|---|---|
| beta_spec | string | – | [wacc] β spec — 2w=2년 주간 (default, 실무 관행), 5m=5년 월간 |
| corp | string | – | 회사명·종목코드·corp_code. market=individual 종목 시세 (kind=market requires exactly one of corp | index | rate_series), wacc=REQUIRED (the subject company), peers=target (동업종 auto-selected). The legacy keys `c… |
| credit_rating | string | – | [wacc] 신용등급 used to derive Kd (무보증 공모회사채, 금투협 시가평가 전 등급). Mid-notches are written with 0, NOT bare: AA0·A0·BBB0. If omitted the 사업보고서 공시등급 is picked up automatically; where none is disclosed Kd is le… |
| equity_basis | string | – | [wacc] Definition of E(자기자본 시가) (default outstanding_plus_nci) |
| exclude | – | – | [peers] Exclusion rules — spac·reit (default)·loss(LTM 순손실)·financial(KSIC 64~66). A bare string is also accepted |
| freq | string | – | [market] Resampling frequency of the series — daily (default)·weekly (금요일 마감)·monthly (월말). Resampled rows drop flt_rt and carry period_return_pct instead (flt_rt compounded over the bucket, %), so r… |
| from | string | – | [market] Start date YYYYMMDD·YYYY-MM-DD (default: one year before `to`) |
| include_pref | boolean | – | [wacc] Add 우선주 시총 into E (default true) |
| index | string | – | [market] 시장지수 — kospi·kosdaq (aliases such as KOSPI/코스피 accepted). Mutually exclusive with corp·rate_series |
| kd | number | – | [wacc] Kd given directly (annual %, 세전) — overrides credit_rating·kd_tenor |
| kd_tenor | string | – | [wacc] Kd(타인자본비용) tenor (default 5y) |
| kind | string | yes | What to fetch — market=시세·지수·금리 time series / wacc=WACC components + CAPM build-up / peers=동업종(KSIC) peer multiples·무차입β·자본구조. Each kind takes a different argument set; an argument that does not appl… |
| ksic | string | – | [peers] KSIC 업종코드 given directly (instead of corp — useful for 비상장 targets). e.g. '26410' |
| limit | number | – | [market·peers] Return cap — market default 600 (1~3000), peers default 15 (3~50) |
| mrp | number | – | [wacc] MRP override (decimal, e.g. 0.08). Default 0.08 = midpoint of the 한국공인회계사회 가이던스 range (7~9%) |
| rate_series | string | – | [market] 시장금리 — ktb1y~ktb50y(국고채)·corp_aa_3y·corp_bbb_3y(회사채 3년)·cd91. Mutually exclusive with corp·index |
| rf_tenor | string | – | [wacc] Rf(무위험이자율) tenor (default 10y) |
| size_band | number | – | [peers] Multiple range around the target's 시총 (e.g. 10 = 1/10~10x; min 2). Only honoured when corp is given |
| srp | number | – | [wacc] SRP override (decimal) — bypasses 분위 판정 |
| srp_scheme | string | – | [wacc] 규모위험 프리미엄(SRP) 분위체계 (default quintile) |
| target_de | number | – | [wacc] Target 자본구조 D/E (시가). If omitted, the snapshot's 실측 value is used |
| tax_rate | number | – | [wacc·peers] 한계법인세율 (default 0.264 = 24%×1.1) |
| to | string | – | [market] End date (default: latest 적재일) |
| yq | string | – | [wacc·peers] 평가기준 분기 (e.g. 2026Q2 — lowercase q accepted). Default: latest snapshot |
No output schema declared.
No examples provided.
get_xbrl ~596
MyDART MCP의 get_xbrl 도구는 공시 첨부 XBRL 을 파싱해 재무제표를 만들고 계산(합산) 검증을 수행합니다. [Purpose] - 합산 검증·XBRL 원본 파일이 필요할 때. 단순 재무수치는 get_financials(scope=full)가 더 넓고 빠릅니다. [Usage] 1. "이 공시 XBRL 로 재무제표 뽑고 합산 검증까지" → rcept_no="20260310002820" 2. "별도 기준 재무상태표만" → rcept_no="…", fs_div="OFS", sections=["BS"] 3. "XBRL 원본 파일 받아줘" → rcept_no="…", format="raw" (local only) [Response] - Generated tables are BS/IS/CF ONLY — CIS·SCE unsupported (use get_financials scope=full). [Rules] - validations_checked=0 means "NOTHING was checked", not "all sums match" — read it together with the (empty) validations array. - fs_div_auto=true only means auto-determined — true whenever fs_div was omitted, even with no switch; an actual CFS→OFS switch is signaled by basis_note presence. - 주석 XBRL is not parsed — format=raw + open the files (local only), or read the 주석 body with download_document. - no_data is not an error — 코넥스·구공시 filings have no XBRL; follow next_step (download_document).
| Name | Type | Req | Description |
|---|---|---|---|
| format | string | – | markdown_full (default): every account in the taxonomy via the presentation linkbase + 계산 검증. markdown: a ~50-tag whitelist summary. raw: unpacks the original XBRL files on the server and returns the… |
| fs_div | string | – | markdown/markdown_full only: 연결(CFS)/별도(OFS). **Automatic when unset** — 연결 is tried first and, if it carries no facts, it switches to 별도 (a company with no 종속회사). The fs_div in the response is the b… |
| out_dir | string | – | format="raw" only: output directory (defaults to the server's standard location) |
| rcept_no | string | yes | 14-digit 접수번호 (separators are stripped automatically) |
| report | string | – | Report type |
| sections | array | – | markdown/markdown_full only: which 재무제표 to generate |
No output schema declared.
No examples provided.
search_audit_findings ~1,626
MyDART MCP의 search_audit_findings 도구는 회사를 지정하지 않고 감사보고서 조건으로 상장사 목록을 찾습니다. [Purpose] - "FY2024 의견거절 회사"·"내부회계 취약점 목록"·"○○회계법인 감사 회사" 류 목록·집계 질문용. - 개별 회사 상세는 get_audit_profile / get_internal_control, 본문 전문은 get_audit_report. [Usage] 1. "FY2024 코스피 의견거절 회사" → year=2024, market="kospi", opinion="disclaimer" 2. "KAM 의무인데 0건·무선언(누락 의심)" → year=2024, kam=false, kam_required=true, kam_none_declared=false [Response] - Output market Y=코스피/K=코스닥/N=코넥스; output fs_div is KOREAN "연결"/"별도". [Rules] - READ coverage.note FIRST — an empty result over a non-ingested scope means "not seen", never "does not exist". - fs_div=both(default) → ≤2 rows/company: row count ≠ company count (dedupe by corp_code). - breakdown = population baseline in the year/market/fs_div scope, ignoring ONLY finding filters (opinion·kam·icfr·auditor 등) — not scope ones; ≠ count. - ICFR undetected rows: `note` ONLY on 연결(CFS) — "legitimately absent (<2조)" vs "expected-audit-but-missing"; 별도(OFS) carries expected_type (or expected_type_note).
| Name | Type | Req | Description |
|---|---|---|---|
| asset_bucket | string | – | Size bucket by 전기말 자산총액(별도). gte_2tn=2조이상, gte_500bn=5천억이상, gte_100bn=1천억이상, lt_100bn=1천억미만. 한글 values also accepted. |
| auditor | string | – | Partial match on 감사인명 (e.g. 삼정/한영/안진/삼일) |
| emphasis | boolean | – | Presence of 강조사항(EoM) |
| fs_div | string | – | 재무제표 구분. CFS=연결, OFS=별도 (aliases consolidated/separate·연결/별도 also accepted). 별도 and 연결 are SEPARATE rows (의견·강조·KAM·ICFR are all held per 별도/연결). both = both (up to 2 rows per company), so row count… |
| going_concern | boolean | – | 계속기업 불확실성 mentioned in the 감사보고서 |
| icfr_material_weakness | boolean | – | A 내부회계관리제도 중요한 취약점 exists |
| icfr_opinion | string | – | 내부회계관리제도 의견. adverse=부적정, disclaimer=의견거절 (covers both 감사 의견거절 and 검토 검토결론 불표명 — use icfr_type to tell 감사 from 검토), modified=변형 (everything other than 적정). 한글 values also accepted. |
| include_reference | boolean | – | Whether to include the 적용시기 참조표 (full phase-in schedule for KAM·ICFR·XBRL 주석·자금부정통제, about 4.8KB). Each company row already carries its own verdict in the applicability field, so set true ONLY when y… |
| industry | string | – | 업종 — financial=금융 (KSIC 64~66: 은행·보험·금융지주 etc.), non_financial=비금융. The 주석 XBRL and ICFR 운영의무 thresholds differ between them. 한글 values (금융·비금융) also accepted. |
| kam | boolean | – | Whether 핵심감사사항(KAM) are present |
| kam_none_declared | boolean | – | Whether the 감사보고서 explicitly declares '보고할 핵심감사사항 없음'. true=declared (kam_count=0 is then normal), false=undeclared or unknown. Combine with kam_count=0 to separate a genuine suspected omission from… |
| kam_required | boolean | – | Whether KAM disclosure was mandatory by 규모·연도·시장 (적용시기 rules). kam=false & kam_required=true & kam_none_declared=false = suspected omission |
| limit | integer | – | Cap on companies returned. When the list is cut here, truncated=true while count still reports the full row count |
| market | string | – | 시장구분. Default all = every 상장사 (유가 kospi·코스닥 kosdaq·코넥스 konex are all loaded). Uppercase (KOSDAQ) and 한글 (코스닥/유가증권/코넥스/전체) aliases accepted. |
| opinion | string | – | 감사의견 filter. unqualified=적정, qualified=한정, adverse=부적정, disclaimer=의견거절, modified=변형의견 (everything other than 적정: 한정/부적정/의견거절). 한글 values (적정·의견거절 etc.) also accepted. |
| other_matter | boolean | – | Presence of 기타사항(OM) |
| xbrl_required | boolean | – | Whether 재무제표 주석 XBRL was mandatory for that year (적용시기 rules). Populated only after the backfill |
| year | integer | yes | 결산 사업연도 (회계연도, fiscal year) — the number you pass IS the 사업연도=회계연도=결산연도. Do NOT subtract it; pass it as-is. Only tools where year is optional auto-select the latest published year when omitted (if ye… |
No output schema declared.
No examples provided.
search_disclosures ~1,144
MyDART MCP의 search_disclosures 도구는 DART 공시 목록에서 접수번호(rcept_no)를 찾습니다 — download_document·get_attachments 진입점. [Purpose] - 회사·기간·공시유형으로 공시를 찾을 때. 사업보고서 섹션의 정형 데이터는 get_periodic_report. - 동명 법인·자회사와 겹치면 find_corp_code 로 corp_code 확정이 먼저입니다. [Usage] 1. "삼성전자 최근 한 달 공시" → corp="삼성전자", days=30 2. "작년 유상증자 결정 회사 전부" → preset="rights_offering", start="2025-01-01", end="2025-12-31" [Response] - corp_cls: Y=코스피, K=코스닥, N=코넥스, E=기타(비상장). - report_nm [기재정정]/[첨부정정]/[첨부추가] prefix = 정정공시. [Rules] - **Always pass corp when the question names a company** — a corp-less batch sweeps every company in 90-day chunks; with corp it is 1 request (152× measured). - Batch counters nest: total_available ≥ total_fetched ≥ matched ≥ returned; matched > returned = cut by limit, incomplete=true = partial collection (see incomplete_note). - early_stopped:true = limit filled, rest unfetched — matched is a **lower bound**, not the period's total. - Preset batch drops 정정공시 by default; page mode and bare all_pages keep them.
| Name | Type | Req | Description |
|---|---|---|---|
| all_pages | boolean | – | Collect the whole period in parallel even without a preset (정정공시 included — the same set as page mode). When true, limit applies instead of page/size. |
| concurrency | integer | – | Collector workers in batch mode (1~10, default 5). **Effective concurrency is set by a server-wide cap, so raising this usually does NOT make it faster** — to cut latency, set corp (which removes the… |
| corp | string | – | 회사명/종목코드/corp_code. Omit for all companies — but a batch without corp splits the period into 90-day chunks and sweeps every company, so DART requests grow to tens~150 and it takes tens of seconds. Wi… |
| days | integer | – | Trailing N days from today instead of start (1~730; out-of-range values are clamped to the bound). When unset, the preset default applies: 사업·감사 460 / 반기 280 / 분기 180 / 수시·일반 90. For windows longer t… |
| end | string | – | End date (defaults to today) |
| final_only | boolean | – | One latest version per event — where a 정정 exists the 구본(원본) is dropped and the latest 정정본 is taken (this does NOT exclude 정정공시 themselves). Use when you need one duplicate-free set. |
| include_corrections | boolean | – | Whether to include 정정공시 ([기재정정] etc.) — preset batch mode ONLY (default false, to avoid double-counting 원본+정정 of the same event; correction_all forces true; ignored when final_only=true since that al… |
| kind | string | – | 공시유형: periodic/major/issuance/holdings/audit/other/fund/abs/exchange/ftc |
| limit | integer | – | Cap on rows finally returned in batch mode (preset given or all_pages=true) |
| page | integer | – | Page number (page mode — the default when neither preset nor all_pages is set). Row shape differs by mode: page mode items are raw DART list rows, batch mode items a 7-key projection (rcept_no·rcept_… |
| preset | string | – | 22 presets: treasury_buy/sell/trust · cb/bw/eb_issue · rights_offering/bonus_issue/capital_reduction · merger/split/stock_exchange · business_transfer/acquisition · large_holding_5pct · annual_report… |
| size | integer | – | Page size (page mode) |
| start | string | – | Start date YYYY-MM-DD. When omitted, `days` back from today (and when that is unset, the preset default: 사업·감사 460 / 반기 280 / 분기 180 / 수시·일반 90) — set it explicitly for older filings. (The old parame… |
No output schema declared.
No examples provided.