yjhann33-design/korea-stock-insight-mcp

Korea Stock Insight MCP is a Python server that lets AI assistants like Claude or Cursor analyze the Korean stock market using natural language. MCP, short for Model Context Protocol, is a standard way for AI tools to connect to external data sources, so this server plugs directly into Claude Desktop, Cursor, Cline, or any compatible AI client without extra coding. The server provides six tools: looking up the current date in Korean time, resolving a company name or ticker into a DART code, fetching recent DART filings, retrieving filing metadata, pulling full financial statements, and getting daily stock price data from KOSPI and KOSDAQ exchanges. DART is South Korea's electronic financial disclosure system, the equivalent of the U.S. SEC EDGAR, operated by the Financial Supervisory Service. Financial statements are returned in XBRL format, a standardized format for financial reports, covering consolidated or separate figures on a quarterly or annual basis. Stock prices come from KRX, the Korea Exchange, via yfinance, and this part requires no separate API key. To use it, you register for a free DART API key, add the server configuration to your Claude Desktop or Cursor config file, and ask questions in plain English, for example, comparing the Q1 2025 operating margins of Samsung Electronics, SK Hynix, and LG Energy Solution. The AI client chains the available tools together automatically to answer the question. The server runs locally over stdio, requires no account beyond the free DART key, has no telemetry, and is released under the MIT license. All tool descriptions are written in English, making it accessible to global analysts researching Korean equities without needing Korean language fluency. The roadmap mentions plans for full disclosure text extraction and multi-company batch queries in future versions.