Korea Stock MCP Server
Analyze Korean stocks via official DART disclosures and KRX (KOSPI/KOSDAQ/KONEX) market data.
Add to your client
Copy the config for your MCP client and paste it into its config file.
npx -y korea-stock-mcp@latestPaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"korea-stock-mcp-server": {
"command": "npx",
"args": [
"-y",
"korea-stock-mcp@latest"
],
"env": {
"DART_API_KEY": "<YOUR_DART_API_KEY>",
"KRX_API_KEY": "<YOUR_KRX_API_KEY>"
}
}
}
}Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
Before you start
- Node.js 18 or higher
- DART API key from OPEN DART (opendart.fss.or.kr)
- KRX API key from the KRX OPEN API portal (6 stock data services enabled; approval takes ~1 day)
- An MCP client such as Claude Desktop
About Korea Stock MCP Server
An MCP server for Korean stock analysis that connects AI clients to the official DART (electronic disclosure) and KRX (Korea Exchange) APIs. It exposes tools to search and parse corporate disclosures, retrieve XBRL financial statements, and query KOSPI/KOSDAQ/KONEX daily prices and basic stock information. Large disclosure documents are handled via an automatic table-of-contents flow so the AI fetches only relevant sections.
Tools & capabilities (8)
get_disclosure_listSearch disclosure reports by type, company, and date.
get_corp_codeLook up a DART-registered company's unique code, company name, and stock code; search by company name (corp_name) or stock code (stock_code).
get_disclosureParse the original disclosure report file via the DART API; for large documents it returns a TOC and a specific section can be fetched with section_id.
get_financial_statementRetrieve XBRL financial statements for listed and major unlisted companies, including all account data from periodic reports.
get_stock_base_infoGet basic information (stock name, code, market classification) for KOSPI, KOSDAQ, and KONEX listed stocks.
get_stock_trade_infoGet daily trading data (price, volume, market capitalization) for KOSPI, KOSDAQ, and KONEX stocks.
get_market_typeQuery the market classification (KOSPI/KOSDAQ/KONEX) for a given stock code.
get_today_dateReturn the current date in YYYYMMDD format for accurate date handling by the AI.
When to use it
- Investigate a Korean company's sales and operating profit across multiple quarters and compute growth rates
- Analyze stock price and market capitalization trends alongside financial growth
- Explain how a company makes money, including sales broken down by business segment
- Extract specific disclosure details such as foreign investor allocation in an IPO
Security notes
Requires two API keys (DART_API_KEY and KRX_API_KEY) passed as environment variables. Obtain a DART key from OPEN DART (opendart.fss.or.kr) and a KRX key from the KRX OPEN API portal (KRX approval takes ~1 day, and you must enable 6 stock data services).
Korea Stock MCP Server FAQ
Which API keys do I need?
Two keys: a DART_API_KEY from OPEN DART (opendart.fss.or.kr) and a KRX_API_KEY from the KRX OPEN API portal. For KRX you must enable 6 stock data services, and approval takes about 1 day.
How does it handle very large disclosure reports?
Automatically. Documents under 1MB are returned in full; documents 1MB or larger return a Table of Contents first, and the AI selects and fetches only the relevant sections (using section_id). No manual action is required.
Which markets are covered?
KOSPI, KOSDAQ, and KONEX via the KRX API, plus disclosure and financial data for listed and major unlisted companies via DART.
Alternatives to Korea Stock MCP Server
Compare all alternatives →
Official Stripe server for payments, customers, subscriptions, invoices, and billing via natural language.
Coinbase's AgentKit MCP extension for onchain actions: transfers, swaps, and contract calls.
Alpaca's official trading server for stocks, ETFs, options, and crypto in plain English.
Compare Korea Stock MCP Server with: