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.
- Category
- Other
- Stars
- ★ 177 Popular
- Transport
- stdio (local process)
- Runtime
- Node.js 18+
- Credentials
- API key / credential required
- License
- ISC
- Last commit
- Tools
- 8
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.
Strongest · Setup experience 13/20 Weakest · Reliability 8/20
Why each score
- Reliability 8/20
- Only the README and server manifest were supplied; no source, CI, or tests could be executed. The manifest's stdio transport and required secret variables are consistent with the README's tool list, so a happy path is plausible, but the init/tool-list handshake, real tool behavior, error handling, and dependency controllability are unverified, which lowers the score.
- Security and permissions 10/20
- API keys are required environment variables, the manifest marks them as secret, and config examples use placeholders only; no real tokens, exfiltration, malware, or destructive defaults are evident. Data flows to DART/KRX official APIs are also disclosed. Deductions are made because no source-level audit is available to confirm log redaction, minimal network scope, least privilege, or confirmation for risky operations.
- Maintenance 10/20
- The repository is not archived, has an ISC license, and the manifest reports active status with version 1.1.5. There is no supplied commit/release history, dependency-update evidence, issue-response track record, or security response channel, so the score reflects active but incomplete governance.
- Documentation 13/20
- The bilingual README covers installation, key registration, Claude Desktop configuration, tool descriptions, local development, examples, and a disclaimer, and it explains large-document section handling. It lacks full parameter schemas, rate limits, cost, and troubleshooting sections, and no reviewable source evidence is present, so it is not scored higher.
- Setup experience 13/20
- The setup path is clearly described: obtain DART/KRX keys, paste configuration into Claude Desktop, run via npx, with npm local development and MCP Inspector instructions and Node 18 noted. However, static calibration caps setup at 15 without verifiable CI and committed tests, and the external API approval process adds manual steps.
Static review · not runListed 2026-08-07
Read the FMRS scoring method →Fit and risk
What it can accessUses the network
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.
Setup
Before you start
Runtime：Node.js 18+
DART_API_KEY
API key for DART (Korea's electronic disclosure system) used for disclosures and financial statements; sign up and apply at opendart.fss.or.kr.
KRX_API_KEY
API key for KRX OPEN API used for stock info and daily trading data; apply at openapi.krx.co.kr (approval takes ~1 day) and request usage for all six stock services.
- 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>"
}
}
}
}
Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.
.vscode/mcp.json
{
"servers": {
"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>"
}
}
}
}
Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).
Terminal
claude mcp add korea-stock-mcp -e 'DART_API_KEY=<YOUR_DART_API_KEY>' -e 'KRX_API_KEY=<YOUR_KRX_API_KEY>' -- npx -y korea-stock-mcp@latest
Run it in a terminal; replace any <…> placeholders with your own values first.
Check that it works
Restart Claude Desktop and check that get_disclosure_list and get_stock_trade_info appear in the tool list; asking "What is today's date?" should return a YYYYMMDD answer via get_today_date, confirming the connection works.
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.
Things to try
Once connected, you can ask your AI assistant things like:
- Show me Samyang Foods' revenue and operating profit by quarter for 2024
- Tell me what HJ Shipbuilding & Construction does and its sales by business segment
- Investigate APR's stock price and market cap trends from 2023 to 2025
- Get the foreign allocation details for an IPO (e.g., Inventera / 0007J0)
Tools 8
get_disclosure_list read-only
Search disclosure reports by type, company, and date.
get_corp_code read-only
Provides unique codes, company names, and stock codes of DART-registered disclosure companies.
get_disclosure read-only
Parse original disclosure report files through DART API; for large documents, returns a TOC for on-demand section retrieval.
get_financial_statement read-only
XBRL financial statements for listed and major unlisted companies, providing all account data from periodic reports.
get_stock_base_info read-only
Basic information for KOSPI, KOSDAQ, and KONEX listed stocks, such as stock names, codes, and market classifications.
get_stock_trade_info read-only
Daily trading data for KOSPI, KOSDAQ, and KONEX stocks, including stock prices, trading volume, and market capitalization.
get_market_type read-only
Query market classification (KOSPI/KOSDAQ/KONEX) by stock code.
get_today_date read-only
Provides current date in YYYYMMDD format for accurate date inquiry.
No matching tools
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 Desktop
Listed from the project's documentation, not tested by this site.
Overview
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.
Similar servers
DuckDuckGo Search MCP Server
74 · B
MCP server providing web search and content fetching via DuckDuckGo
Basic Memory
72 · B
Your AI never forgets again.
Telegram MCP Server
70 · B
Telegram MCP server powered by Telethon to let MCP clients read chats, manage groups, and send/modify messages, media, contacts, and settings.
Hostinger API MCP Server
70 · B
Official MCP server for Hostinger API.
Source revision 210595eec73a Data synced 2026-10-12 Read the FMRS scoring method