open-esg-korea

open-esg-korea is an MCP (Model Context Protocol) server that enables natural language queries for ESG information of South Korean listed companies within AI clients. Developed by a securities analyst, it shares the same architecture as its sibling project, open-proxy-mcp (DART disclosure analysis). ■ Data Sources and Methods It aggregates ESG/E/S/G ratings from five agencies (KCGS, MSCI, Korea ESG Research Institute, S&P, Sustinvest) via the KRX ESG Portal, corporate governance reports and sustainability reports from KIND (extracting text from PDFs), and greenhouse gas (GHG) statements and emission trading system data from the GIR (Greenhouse Gas Inventory and Research Center). No API keys are required for these sources; ratings are fetched in real-time without being stored. Every data point includes its source, year, and terms of use. ■ Installation Users can download the platform-specific .mcpb file (approx. 40-44MB for macOS/Windows) from the releases page and drag it into the Claude Desktop settings. It includes a bundled Python runtime, eliminating the need for separate Python installations or API keys. For ChatGPT, it guides connection via Codex (CLI/IDE extensions). The bundle contains the runtime, dependencies (mcp, httpx, pypdfium2, pdfplumber), the server, manifest, and build info. ■ 12 Tools 1. company: Query company names and ticker codes. 2. esg_ratings: Ratings by agency and distribution within the same agency. 3. sustainability_reports: List of reports, verification agencies, and PDF links. 4. sustainability_report_text: Keyword search, excerpts, and page viewing in PDFs. 5. governance_indicators: 15 core indicators (O/X) and compliance rates. 6. governance_policies: 74 policy items. 7. governance_report: Full report text, 28 detailed principles, and reasons for non-compliance. 8. esg_disclosures: Disclosure history. 9. esg_screener: Screener for all KOSPI ratings (795 companies as of 2025). 10. ghg_emissions: Company emissions, 5-year trends, and vs. allocation. 11. ghg_industry: Emission rankings by designated industry and corporation. 12. ghg_national_inventory: National inventory time series since 1990. ■ Usage Notes Users are cautioned that rating scales vary by agency (e.g., KCGS S-D, MSCI AAA-CCC, S&P 0-100, Sustinvest AA-E) and should not be compared directly. '-' indicates unrated, not a zero or bad grade. Industry classifications differ across systems (GICS, KRX, GIR). Governance data is provided in two layers: KRX aggregates and original text. GHG data prioritizes boundaries (Scope 2, NF₃ inclusion) over raw values. Automated table extraction from reports is experimental (97.4% value preservation), and PDF search ignores character spacing and cannot read images without OCR. Receipt numbers are from KIND, differing from DART. ■ License and Copyright The code is Apache-2.0, allowing free use, modification, and distribution with attribution. However, this does not apply to the data. ESG ratings are copyrighted by the respective agencies, and public disclosure is restricted. Users must contact agencies to collect, store, or resell ratings. The server does not store ratings beyond a memory cache and requests that the license field in responses remain intact. ■ For Developers Install dependencies via uv and run using 'python -m open_esg_korea' (HTTP or stdio). It can be registered in claude_desktop_config.json for local connection. Scripts are provided for building platform-specific extensions, checking tool responses, and running pytest. It also includes scripts for updating GICS/listing snapshots and smoke tests for KRX/KIND access.