Best for
- Korean stock investors who need access to official disclosure and financial reports
- Financial analysts focusing on the Korean market
- Developers wanting to streamline Korean stock research with AI
K
Korea Stock MCP
Community
MCP server for Korean stock analysis using official DART and KRX APIs.
GitHub source repository ↗
54FMRS · D
This MCP server provides official API access to Korean stock data and disclosure documents, making it ideal for Korean stock investors seeking reliable information. Its main strengths are the use of official DART and KRX data sources and the variety of tools for comprehensive analysis. Users need to manage API keys carefully and be aware of handling large documents.
korea-stock-mcp is an MCP server for Korean stock analysis, leveraging official APIs from DART (Data Analysis, Retrieval and Transfer System) and KRX (Korea Exchange) to provide stock price information, disclosure data, XBRL financial statements, and daily trading data. This server enables AI models to retrieve reliable Korean stock market data for analysis and queries.
Tools
get_disclosure_list
Search disclosure reports by type, company, and date.
get_corp_code
Provides unique codes, company names, and stock codes of DART-registered disclosure companies.
get_disclosure
Parse original disclosure report files through DART API; for large documents, returns a TOC for on-demand section retrieval.
get_financial_statement
XBRL financial statements for listed and major unlisted companies, providing all account data from periodic reports.
get_stock_base_info
Basic information for KOSPI, KOSDAQ, and KONEX listed stocks, such as stock names, codes, and market classifications.
get_stock_trade_info
Daily trading data for KOSPI, KOSDAQ, and KONEX stocks, including stock prices, trading volume, and market capitalization.
get_market_type
Query market classification (KOSPI/KOSDAQ/KONEX) by stock code.
get_today_date
Provides current date in YYYYMMDD format for accurate date inquiry.
Setup
- Obtain DART and KRX API keys from OPEN DART and KRX OPEN API websites.
- In Claude Desktop, go to Settings > Developer > Edit Configuration, and add the config JSON to claude_desktop_config.json.
- Restart Claude Desktop.
claude_desktop_config.json
{
"mcpServers": {
"korea-stock-mcp": {
"command": "npx",
"args": [
"-y",
"korea-stock-mcp@latest"
],
"env": {
"DART_API_KEY": "<YOUR_DART_API_KEY>",
"KRX_API_KEY": "<YOUR_KRX_API_KEY>"
}
}
}
}
Fit and risk
Not for
- Users seeking coverage of global stock markets
- Users needing real-time market data or high-frequency trading
- Those who expect investment advice rather than information
Required permissions
- Requires DART_API_KEY and KRX_API_KEY environment variables
- Interacts with AI clients (e.g., Claude Desktop) via stdio
Risks and side effects
- The tool is for informational purposes only and not investment advice; users are responsible for investment decisions, as per disclaimer.
- API keys are secret; manage them securely to avoid exposure.
- Large disclosure documents may cause long response times or failures.
Troubleshooting
- If connection fails or tools are not loading, ensure environment variables are set correctly.
- If DART or KRX APIs return errors, check that you have applied for the required services.
- If document processing fails, try breaking down the question into smaller steps.
- If using Claude Desktop, ensure you've restarted it.
Use cases
Analyze financial data of Korean listed companies, such as revenue, operating profit, and growth rates.
Search and parse corporate disclosure reports to extract specific information like foreign allocation details in an IPO.
Query daily stock prices, trading volumes, and market capitalization for Korean stocks to track market trends.
Supported clients
Claude DesktopFull support