Korea Stock
Search company disclosures and financial statements from the Korean market. Retrieve stock profile…
What is Korea Stock?
Korea Stock is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to search company disclosures and financial statements from the korean market. retrieve stock profile…
Search company disclosures and financial statements from the Korean market. Retrieve stock profile…
This server falls under the Finance & Fintech category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- get_corp_code
- get_disclosure_list
- get_disclosure
- get_financial_statement
- get_market_type
Use Cases
Maintainer
Works with
Installation
NPM
npx -y korea-stock-mcpManual Installation
npx -y korea-stock-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Korea Stock
Korea Stock MCP is a TypeScript-based Model Context Protocol server that connects AI assistants to Korean capital market data through two official APIs: OPEN DART (Financial Supervisory Service) and KRX OPEN API (Korea Exchange). It provides tools to look up company codes, search and retrieve corporate disclosure reports, access XBRL financial statements, and query real-time stock trading data including prices, volumes, and market capitalisation across KOSPI, KOSDAQ, and KONEX. Analysts and developers use it to automate fundamental research on Korean-listed companies directly from their AI workflows.
Prerequisites
- Node.js 18 or later and npx available in your PATH
- A DART API key from OPEN DART at https://opendart.fss.or.kr (free registration required)
- A KRX API key from KRX OPEN API at https://openapi.krx.co.kr (free registration required)
- An MCP-compatible client such as Claude Desktop, Cursor, or Windsurf
Register for DART and KRX API keys
Visit https://opendart.fss.or.kr to register for a free DART_API_KEY, and https://openapi.krx.co.kr for a free KRX_API_KEY. Both keys are required; the server will not start without them.
Add the server to your MCP client configuration
Open claude_desktop_config.json and add the korea-stock-mcp entry, supplying both API keys in the env block. The server runs directly via npx with no separate install step.
{
"mcpServers": {
"korea-stock-mcp": {
"command": "npx",
"args": ["-y", "korea-stock-mcp@latest"],
"env": {
"DART_API_KEY": "your_dart_api_key_here",
"KRX_API_KEY": "your_krx_api_key_here"
}
}
}
}Restart your MCP client
Restart Claude Desktop or your chosen MCP client so it picks up the new server configuration and the environment variables take effect.
Look up a company code
Use the get_corp_code tool to find the DART corporate code for a company by name or ticker before querying disclosures or financials.
Query disclosures and financial data
Use get_disclosure_list to search filings by type and date range, get_disclosure to read the full text of a specific report, and get_financial_statement to fetch structured XBRL financial data.
Korea Stock Examples
Client configuration
claude_desktop_config.json entry for the Korea Stock MCP server with DART and KRX API keys.
{
"mcpServers": {
"korea-stock-mcp": {
"command": "npx",
"args": ["-y", "korea-stock-mcp@latest"],
"env": {
"DART_API_KEY": "your_dart_api_key_here",
"KRX_API_KEY": "your_krx_api_key_here"
}
}
}
}Prompts to try
Example prompts for Korean stock market research using the available DART and KRX tools.
- "Find the DART corporate code for Samsung Electronics and retrieve its latest annual disclosure."
- "Get the income statement and operating profit trend for Kakao Corp from 2022 to 2024."
- "Search for all quarterly earnings disclosures filed by POSCO in the last 6 months."
- "What is the current market type (KOSPI/KOSDAQ/KONEX) for ticker 005380?"
- "Retrieve today's trading volume and closing price for NAVER (035420) on KRX."Troubleshooting Korea Stock
API requests fail with an authentication error or 401 response
Double-check that both DART_API_KEY and KRX_API_KEY are set correctly in the env block of your MCP config. Keys are obtained separately from opendart.fss.or.kr and openapi.krx.co.kr — they are not interchangeable.
get_disclosure returns a table of contents instead of full content
This is expected behaviour for large disclosure documents. The tool returns a TOC for lengthy filings; select the specific section you need from the TOC and request that section in a follow-up call.
npx takes a long time to start or fails with a network error
The first run downloads the package. Ensure you have internet access and that npm's registry is reachable. If behind a corporate proxy, set the HTTP_PROXY and HTTPS_PROXY environment variables in your shell before starting the MCP client.
Frequently Asked Questions about Korea Stock
What is Korea Stock?
Korea Stock is a Model Context Protocol (MCP) server that search company disclosures and financial statements from the korean market. retrieve stock profile… It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Korea Stock?
Install via npm with the command: npx -y korea-stock-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Korea Stock?
Korea Stock works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Korea Stock free to use?
Yes, Korea Stock is open source and available under the ISC license. You can use it freely in both personal and commercial projects.
Korea Stock Alternatives — Similar Finance & Fintech Servers
Looking for alternatives to Korea Stock? Here are other popular finance & fintech servers you can use with Claude, Cursor, and VS Code.
ValueCell
★ 10.7kValueCell is a community-driven, multi-agent platform for financial applications.
Vibe Trading
★ 8.1k'Vibe-Trading: Your Personal Trading Agent'
Quantdinger
★ 6.2kAI quantitative trading platform for crypto, stocks, and forex with backtesting, live trading, market data, and multi-agent research.vibe-trading ,trading-agents,ai-trader,ai-trading
TradingView
★ 2.8kReal-time crypto & stock screening, advanced technical indicators, Bollinger Bands intelligence, candlestick patterns + native Claude Desktop integration. Multi-exchange (Binance, KuCoin, Bybit+). Open-source AI trading infrastructure.
Financial Datasets
★ 2.1kProvides access to comprehensive financial data including income statements, balance sheets, cash flow statements, stock prices, company news, SEC filings, and cryptocurrency information with built-in financial ratio analysis.
Stripe
★ 1.6kThe Stripe Model Context Protocol server allows you to integrate with Stripe APIs through function calling. This protocol supports various tools to interact with different Stripe services.
Browse More Finance & Fintech MCP Servers
Explore all finance & fintech servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Korea Stock in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Korea Stock?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.