OpenProxy

What is OpenProxy about?

OpenProxy extracts, parses, and structures public disclosures from Korea's DART system, exposing financial statements, valuation metrics, ownership structures, business operations, and shareholder‑meeting agenda items as tools that can be invoked by AI assistants such as Claude, ChatGPT, or Perplexity.

How to use OpenProxy?

1. Obtain a free OpenDART API key.
2. Add a custom connector in the target AI service and set the endpoint to: https://open-proxy-mcp.fly.dev/mcp?opendart=<YOUR_API_KEY>
3. In a chat session, ask natural‑language questions about a listed company; the connector automatically calls the appropriate tool and returns answers with source citations.

Key Features of OpenProxy

• Proxy‑voting assistance – structures meeting notices, provides FOR/AGAINST/REVIEW recommendations with legal and financial justification.
• Financial metrics – profitability, stability, cash‑flow analysis, DuPont decomposition, audit‑opinion trends, QoQ/YoY comparisons.
• Valuation suite – PER, PBR, dividend yield, historical market/industry data, full calculation traceability.
• Asset‑holdings screening – tiers cash‑like assets, investment real estate, equity holdings; marks market‑value‑based hidden assets.
• Business‑detail extraction – revenue, profit per segment, production capacity, R&D, order backlog, major customers, input‑cost vs price trends.
• Provisional earnings digest – quarterly provisional results with tables and change rates.
• Shareholder‑return tracking – dividend and treasury‑share buy‑back cycles vs disclosed plans.
• Ownership & governance map – major shareholders, related parties, 5% large‑shareholders, treasury shares.
• Meeting agenda structuring – agenda items, candidate info, compensation limits, charter changes, voting results.
• Control‑contest signals – proxy‑statement, tender‑offer, lawsuit, 5% participation signals.
• Risk‑event monitoring – major accidents, embezzlement, production stoppages, with market‑wide scanning.
• Daily market digest – consolidated view of orders, share‑buybacks, dividends, capital increases, AGM items, and 5% holdings.
• 25+ dedicated tools covering company identification, data extraction, evidence linking, and action‑oriented advice.

Use Cases of OpenProxy

• Shareholder meeting preparation – advisors quickly obtain agenda summaries and voting recommendations for any listed Korean company.
• Equity research – analysts retrieve financial ratios, valuation calculations, and business‑segment performance with source traceability.
• Stewardship & ESG monitoring – investors monitor risk events, governance disputes, and sustainability‑related disclosures.
• Asset‑holdings discovery – fund managers identify hidden asset NAV multiples and surplus holdings.
• Regulatory compliance – corporate secretaries verify that proxy‑voting advice follows the Open Proxy Guideline and legal constraints.

FAQ from OpenProxy

Q: Do I need to install any software? A: No. OpenProxy runs as a hosted MCP endpoint; you only need to supply your OpenDART API key.

Q: Which AI platforms are supported? A: Claude, ChatGPT, Perplexity, and any other service that allows custom MCP connectors.

Q: Is there a usage limit? A: The underlying DART API limits calls to 1,000 per minute; OpenProxy enforces a hard cap of 910 calls per minute.

Q: Can I use OpenProxy for commercial purposes? A: The project is released under the PolyForm Non‑Commercial license. Commercial use requires a separate license agreement.

Q: How are sources cited? A: Every response includes an evidence field referencing the original DART document number and tool‑call usage.

OpenProxy MCP

English README

Why OpenProxy?

주총 안건에 제대로 투표하려면, 그 회사의 모든 것을 알아야 합니다.

OpenProxy는 주주총회 의결권 분석을 위해 태어났습니다. 그런데 안건 하나를 판단하려면 재무제표, 지분 구조, 배당 이력, 이사회, 법령까지 전부 필요했습니다. 그걸 다 만들다 보니 — DART 공시분석 범용 엔진이 됐습니다. 재무 분석부터 의결권 판단까지, AI에게 물어보면 몇 초 안에 공시 근거와 함께 답합니다.

사업보고서·감사보고서 등 공시를 근거로 재무를 분석합니다 — OpenProxy를 연결한 AI 대화 예시

그리고 이것이 원점 — 소집공고·법령·지배구조보고서를 묶어 안건별 의견과 근거를 제시합니다

주요 기능

각 기능을 클릭하면 상세 설명 페이지로 이동합니다.

• 주총 의결권 보조: 소집공고 안건을 구조화하고 안건별 FOR/AGAINST/REVIEW 권고와 근거를 제시합니다.
• 재무지표: 수익성·안정성·현금흐름 + 듀퐁 분해·감사의견 추이. 분기는 누적(YTD)·당기(3개월) 두 기준으로 QoQ·YoY 제공.
• 밸류에이션: PER·PBR·배당수익률(기업 심층) + 시장·산업·종목 히스토리. scope="explain"으로 계산 과정·출처까지 답합니다.
• 자산주 스크리닝: 보유 자산(현금성·투자부동산·지분증권)을 티어로 나누고 상장 보유지분은 시가로 마킹 — 시총 대비 잉여자산·지분NAV 배수로 "숨은 자산"을 찾습니다.
• 사업의 내용: 사업부문별 매출·이익, 생산설비·가동률, 연구개발, 수주잔고, 주요 고객, 원재료·투입원가와 제품·서비스 가격 추이 — "II. 사업의 내용"을 통째로 읽어줍니다.
• 잠정실적 속보: 분기 영업(잠정)실적 공시를 표·증감률로 정리합니다.
• 주주환원: 배당·자사주 소각 사이클·밸류업 계획 — 약속과 실제 집행을 비교합니다.
• 지분·지배구조 맵: 최대주주·특수관계인·5% 대량보유·자사주로 소유 구조를 그립니다.
• 주총 안건 구조화: 소집공고 안건·후보·보수한도·정관변경과 주총 후 의결 결과·찬반율.
• 경영권 분쟁 시그널: 위임장·공개매수·소송·5% 경영참여 신호를 모아 정황을 나열합니다 (자동 판정 X).
• 기업 리스크 이벤트: 중대재해·횡령배임·생산중단 추적. 회사 미지정 시 시장 전체 스캔.
• 전체시장 공시 디제스트: 수주·자사주·배당·증자·주총·5%지분·잠정실적 공시를 한 번에 훑어 카드형으로 요약 — 매일 아침 공시 알람 루틴 (레시피).

그 외 출처 추적, 기업지배구조보고서, 희석 이벤트(증자/CB), 구조개편(합병/분할), 지분 인수·매각, 정관↔법령 양방향 조회 등 총 25개 tool을 제공합니다.

---

빠른 시작

OpenProxy MCP는 Claude, ChatGPT, Perplexity 같은 AI 서비스에 연결해서 쓰는 도구입니다. 설치는 필요 없습니다.

1단계: DART API 키 발급 (필수·무료)

OPM은 DART·거래소 공시 원문과 OpenDART API, 3개 소스를 함께 씁니다. 이 중 OpenDART API 호출에 본인의 키가 필요합니다. DART OpenAPI 접속 → 회원가입 → 인증키 신청 (바로 발급됩니다).

2단계: AI 서비스에 연결

사용하는 AI 서비스의 커넥터(앱) 추가 화면에 아래 주소를 등록합니다.

https://open-proxy-mcp.fly.dev/mcp?opendart=발급받은_OpenDART_API_키

API 키 주의: 위 주소에는 본인의 API 키가 들어갑니다. 일반 채팅창에 붙여넣지 말고, 커넥터 설정의 서버 주소 입력칸에만 넣으세요.

공통 절차는 같습니다 — 커넥터 추가 메뉴에서 이름 open-proxy-mcp + 위 URL 입력 → 새 채팅에서 + 버튼으로 커넥터 선택 확인:

서비스	메뉴 경로	비고
Claude	설정 → 커넥터 → 맞춤 설정 → 커넥터 추가	유료 플랜 필요. 추가 후 도구 권한을 항상 허용으로
ChatGPT	설정 → 앱 → 고급설정에서 개발자 모드 ON → 앱 만들기	새 채팅 + → 더보기에서 선택
Perplexity	설정 → 커넥터 → 사용자 지정 커넥터 추가	—

참고: 요금제·계정 설정에 따라 커넥터 메뉴가 없을 수 있습니다. 처음엔 서버 기동에 시간이 걸려 타임아웃이 날 수 있으니 잠시 후 재시도하세요. 새 기능이 안 보이면 커넥터를 삭제 후 재연결하면 빨리 반영됩니다.

사용 예시

연결이 끝났다면 자연어로 이어서 질문하면 됩니다. tool 이름을 알 필요는 없습니다.

주총 안건 검토

1. LG화학 2026년 정기 주주총회 안건 알려줘
2. 각 안건별로 찬성/반대/보류 의견을 조언해줘
3. 보류로 나온 안건은 어떤 근거 때문에 보류인지 설명해줘

주주환원 점검

1. KT&G 기업가치제고계획 알려줘
2. 지난 3년 배당·자사주 취득 이력도 같이 보여줘
3. 계획과 실제 주주환원이 일관적인지 정리해줘

리스크 모니터링

1. 최근 한 달 사이에 중대재해나 횡령 공시 낸 상장사 알려줘
2. 한화에어로스페이스 중대재해 이력을 사상자까지 자세히 보여줘

더 많은 예시(이사 보수·경영권 분쟁·재무·밸류 등 도구별 질문 모음) → docs/examples/

---

Tool 구조 (25개)

Company → Meeting/Data/Evidence → Action 흐름으로 동작합니다 (법령 조회는 회사 무관 Reference).

Layer	Tools	역할
Company	company	기업 식별과 공통 공시 인덱스
Meeting	shareholder_meeting_notice, shareholder_meeting_results	주총 전/후 데이터
Data	corp_gov_report, director_board, corporate_restructuring, dilutive_issuance, dividend, financial_metrics, valuation, business_details, provisional_earnings, asset_holdings, ownership_structure, corporate_deals, order_contracts, proxy_contest, risk_events, treasury_share, value_up	개별 공시/재무/사업/지배구조 파싱
Evidence	evidence	공시번호 기반 출처 추적
Action	proxy_advise_before_meeting, shareholder_commitment, screener	여러 data tool을 묶어 판단·비교·디제스트 생성
Reference	law_lookup	정관↔법령 양방향 조회 (상법·자본시장법 등 원문) — API 0콜

도구별 예시 질문 → docs/examples/ · 상세 스키마·데이터 출처 → wiki/tools 카탈로그

의결권 정책

proxy_advise_before_meeting은 OPM 자체 Open Proxy Guideline을 기본 정책으로 사용합니다. 판단 기준은 소수주주 보호, 거버넌스 투명성, 장기 가치, 추적 가능성입니다. 익명화된 기관 정책 corpus는 내부 cross-reference로만 쓰며 기관 실명을 노출하지 않습니다. 모든 응답에는 data.usage(DART·tool 호출 수)가 포함됩니다 (DART 분당 1,000 한도 — cap 910 hard guard).

어느 해 재무제표로 판단하나 — 자본잠식·배당재원 같은 회사 상태는 승인 대상 연도로 봅니다. 주총일 시점에 그 해 사업보고서가 이미 제출돼 있으면 확정치(FY2025A)를, 아직이면 소집공고에 실린 잠정치(FY2025P)를, 둘 다 없으면 직전 확정치를 씁니다. 기준일이 주총일이라 그때 알 수 없던 정보는 쓰지 않습니다. 잠정치로 판단한 경우 그 사실이 문장에 표시되며, 관리종목 판정은 감사 후 재무제표 기준이라 잠정치로는 규정 판정을 내리지 않습니다.

---

데이터 소스

소스	용도	비고
DART OpenAPI	정기·주요 공시 메타 + 재무 endpoint + 배당/자사주/지분 등 정형 데이터	필수 — 무료 API 키. 분당 1,000회 hard rule (cap 910)
DART 웹 (dart.fss.or.kr)	공시 본문 파싱 (소집공고·주요사항보고서 등)	rate-limited (2–5초)
KRX KIND	거래소 공시 보조 확인	보조 소스
익명화 기관 정책 corpus	의결권 판단 cross-reference	내부 정적 데이터, 실명 비노출

---

릴리즈 노트

버전별 변경 이력 → docs/RELEASE_NOTES.md

---

Disclaimer

OpenProxy는 DART 공시 데이터를 구조화하여 AI에게 제공하는 도구입니다. AI는 할루시네이션을 일으킬 수 있고 부정확한 분석을 제공할 수 있습니다. AI가 제시하는 의견은 개발자 또는 소속 단체의 의견이 아닙니다. 분석 결과는 참고 목적으로만 사용하고, 투자 결정이나 의결권 행사의 최종 판단은 반드시 원문 공시와 전문가 검토를 거쳐야 합니다.

---

라이선스

PolyForm Noncommercial License 1.0.0 — 비상업적 사용만 허용 (전문: 루트 LICENSE)

• 비상업적 사용(개인 연구·학습·비영리·공공기관)은 자유롭게 허용됩니다.
• 상업적 사용은 별도 라이선스 계약이 필요합니다 (OpenProxy AI).
• 재배포 시 출처 표기: Copyright (c) 2026 OpenProxy AI (https://github.com/MarcoYou/open-proxy-mcp) 유지 (PolyForm 'Notices' 조항).

상업 라이선스·기타 문의: gunhoqw20@gmail.com