OpenProxy MCP

English README

Why OpenProxy?

Governance risk lies at the heart of the "Korea Discount." As passive investing grows and the meaning of stock ownership becomes diluted, this risk is becoming even more apparent. While it is essential to have easy access to governance information and the ability to analyze it quickly, most people lack the time and expertise to read and interpret hundreds of pages of original disclosure documents.

OpenProxy breaks down this barrier with AI. By transforming DART disclosures into structured data, we have made it possible for anyone to perform comprehensive governance analysis—from ownership structures and dividend history to shareholder meeting agendas and management disputes—in just a few seconds.

Related MCP server: OpenDART MCP Server

Quick Start

Step 0: Verify Claude Subscription (Required)

MCP connectors are only available to Claude Pro, Max, and Teams subscribers. Please check your subscription status at claude.ai.

Step 1: Obtain DART API Key (Required)

All data in OpenProxy is sourced from the DART OpenAPI. You must have your own API key to use it.

1. Visit DART OpenAPI -> Sign up

2. Apply for an authentication key -> Issued (Free, issued immediately)

Step 2: Connection

Once you have your API key, choose one of the two methods below.

Method A: Remote Server (Takes 30 seconds, no installation required)

Connect by appending your issued DART API key to the end of the URL. The key is used only on the server and is not exposed to the AI.

claude.ai Web:

1. Go to claude.ai -> Settings -> Connectors

2. Select "Add Custom Connector"

3. Name: open-proxy-mcp, Enter URL:

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

4. Click "Add" -> 12 tools will be automatically recognized.

5. Configure the added connector -> Select "Always Allow" under permissions (this allows tools to run automatically without needing approval every time).

Note: If tools are added or changed, it may take some time for the connector MCP server to update. If you delete and reconnect the connector, the latest tools will be reflected immediately. After reconnecting, please open a new chat to try again.

Usage Example

Once connected, you can ask questions in natural language:

"삼성전자 주주총회 안건 분석해줘"
"KB금융 사외이사 후보 독립성 검토해줘"
"현대차 보수한도 적정성 판단해줘"
"삼성전자 지분 구조 보여줘"
"SK하이닉스 배당 추이 알려줘"
"고려아연 경영권 분쟁 분석해줘"
"최근 30일 자사주 소각 결정한 KOSPI 기업 찾아줘"
"최근 60일 임시주총 소집한 기업 리스트업해줘"

• Please note that OpenProxy does not currently analyze DART financial metrics (updates coming soon).

Tool Structure (12)

The 12 tools are divided into three stages: Discovery → Data Tab → Output Generation.

company                      # 기업 진입점 — 1개 기업 식별 + 최근 공시 인덱스
│
├─ Discovery Tool (1)
│  └─ screen_events          # 이벤트로 기업 찾기 (14종 event_type, KOSPI+KOSDAQ)
│
├─ Data Tools (7)
│  ├─ shareholder_meeting    # 주총 (안건 / 이사후보 / 보수한도 / 결과)
│  ├─ ownership_structure    # 지분 구조 (최대주주 / 5% 블록 / 자사주 / 변동신고서)
│  ├─ dividend               # 배당 사실 (DPS / 배당성향 / 추이)
│  ├─ treasury_share         # 자사주 이벤트 (취득 / 처분 / 소각 / 신탁)
│  ├─ proxy_contest          # 경영권 분쟁 (위임장 / 소송 / 5% 시그널)
│  ├─ value_up               # 밸류업 계획 (약속 / 이행현황)
│  └─ evidence               # 공시 원문 링크 (rcept_no → viewer_url)
│
└─ Action Tools (3)
   ├─ prepare_vote_brief      # 의결권 행사 메모
   ├─ prepare_engagement_case # 주주관여 케이스 메모
   └─ build_campaign_brief    # 캠페인 브리프

There are two usage patterns:

패턴 A (기업 → 분석):     company로 시작 → 데이터 탭으로 사실 확인 → action tool로 결과물 생성
패턴 B (이벤트 → 기업):   screen_events로 최근 이벤트 낸 기업 찾기 → 각 기업 drill-down

Events supported by screen_events (14 types)

The default lookup period is the last 30 days, and the market is KOSPI+KOSDAQ. Each row in the results includes a link to the original DART disclosure viewer.

Summary by Domain

Voting Decision Support

When you request a voting decision for a shareholder meeting agenda, it provides FOR/AGAINST/REVIEW opinions based on the following criteria:

Data Sources

Project Structure

open-proxy-mcp/
  open_proxy_mcp/
    server.py              # FastMCP 서버 (stdio + HTTP)
    tools_v2/              # 12개 tool
    services/              # 도메인별 분석 로직 (tool과 분리)
    dart/client.py         # DART API + KIND 크롤링 + 네이버 + rate limiter
  Dockerfile               # Fly.io 배포용 컨테이너
  fly.toml                 # Fly.io 설정 (nrt 리전, auto-suspend)
  wiki/                    # 도메인 지식 위키

Disclaimer

OpenProxy is a tool that structures DART disclosure data for AI. AI can hallucinate and may provide inaccurate analysis. Opinions provided by the AI are not the opinions of the developer or the developer's organization. Analysis results are for reference only; please ensure you review original disclosures and consult experts for final investment decisions or voting actions.

License

CC BY-NC 4.0 -- Non-commercial use only.

Please cite the source when using the code and data from this project. It cannot be used for commercial purposes.