Korea Stock MCP
MCP server giving AI assistants access to Korean stock prices and DART disclosures
- Pricing
- Open source
- Platforms
- CLI, API, self-hosted
- Runs
- Locally
- Version
- 1.1.4
- Listing updated
- today
Similar MCP servers
About Korea Stock MCP
Korea Stock MCP is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
The README says this server connects AI clients to official Korean market data, pulling daily KOSPI, KOSDAQ and KONEX trading figures from the Korea Exchange and corporate filings from the DART electronic disclosure system. Once configured, an assistant can look up company codes, search filings by company and date, and read parsed disclosure text or XBRL financial statement line items.
Large annual and quarterly reports are handled by returning a table of contents first when a document exceeds about 1 MB, so the assistant can request only the sections relevant to a question. The project also includes example analyses covering sales, operating profit and market capitalization trends for specific listed companies.
The server is aimed at developers and investors who want an assistant to research Korean listed companies. It requires separate DART and KRX API keys, and the README states that its output is informational and not investment advice.
Install
Run in a terminal
claude mcp add korea-stock-mcp --env DART_API_KEY='<DART_API_KEY>' --env KRX_API_KEY='<KRX_API_KEY>' -- npx -y korea-stock-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"korea-stock-mcp": {
"command": "npx",
"args": [
"-y",
"korea-stock-mcp"
],
"env": {
"DART_API_KEY": "<DART_API_KEY>",
"KRX_API_KEY": "<KRX_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"korea-stock-mcp": {
"command": "npx",
"args": [
"-y",
"korea-stock-mcp"
],
"env": {
"DART_API_KEY": "<DART_API_KEY>",
"KRX_API_KEY": "<KRX_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"korea-stock-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"korea-stock-mcp"
],
"env": {
"DART_API_KEY": "<DART_API_KEY>",
"KRX_API_KEY": "<KRX_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"korea-stock-mcp": {
"command": "npx",
"args": [
"-y",
"korea-stock-mcp"
],
"env": {
"DART_API_KEY": "<DART_API_KEY>",
"KRX_API_KEY": "<KRX_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"korea-stock-mcp": {
"command": "npx",
"args": [
"-y",
"korea-stock-mcp"
],
"env": {
"DART_API_KEY": "<DART_API_KEY>",
"KRX_API_KEY": "<KRX_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
DART_API_KEYDART API key for the serviceRequiredKRX_API_KEYKRX API key for the serviceRequired
Tools this server provides (8)
Taken from the project documentation; the running server may differ.
- get_disclosure_list
- Search disclosure reports by type, company and date.
- get_corp_code
- Look up DART corporate codes, company names and stock codes.
- get_disclosure
- Fetch parsed original disclosure report content, with section access for large documents.
- get_financial_statement
- Retrieve XBRL financial statement account data from periodic reports.
- get_stock_base_info
- Basic information for KOSPI, KOSDAQ and KONEX listed stocks.
- get_stock_trade_info
- Daily trading data including prices, volume and market capitalization.
- get_market_type
- Return the market classification of a stock code.
- get_today_date
- Return the current date in YYYYMMDD format.
What it does
- Disclosure search
- Finds DART filings by company, disclosure type and date range.
- Parsed filing content
- Returns the text of original disclosure reports, with a table of contents for large documents.
- XBRL financial statements
- Provides account-level data from periodic reports for listed and major unlisted companies.
- Daily trading data
- Supplies daily prices, volume and market capitalization for KOSPI, KOSDAQ and KONEX stocks.
- Corporate code lookup
- Maps company names or stock codes to DART corporate codes.
- Section-level fetching
- Retrieves a specific section of a large filing by its section identifier.
Good for
- Pulling quarterly sales and operating profit for a Korean listed company
- Finding the foreign investor allocation in an IPO securities registration filing
- Checking daily trading volume and market cap trends for a KOSDAQ stock
- Summarising a company's business segments from its annual report
Pricing
Open source
Free open-source server under the ISC license; requires free DART and KRX API keys.
Korea Stock MCP FAQ
What API keys are required?
Both a DART API key and a KRX API key are required. The README explains how to apply for each, and notes that KRX approval can take about one day.
How are large filings handled?
Documents of 1 MB or more are returned as a table of contents first, and the assistant then fetches the sections it needs.
What Node version is needed for local development?
The README says Node.js 18 or higher is required.
Is Korea Stock MCP free?
Yes. Korea Stock MCP is open source, so you can use and self-host it for free.
How do I add Korea Stock MCP to Claude Code?
Run this command in your terminal: claude mcp add korea-stock-mcp --env DART_API_KEY='<DART_API_KEY>' --env KRX_API_KEY='<KRX_API_KEY>' -- npx -y korea-stock-mcp
What are the best alternatives to Korea Stock MCP?
The closest alternatives to Korea Stock MCP are FinBridge, stocks-llm, Hedgenaru Korean Stocks, MCP Stock Analyst and 0si.ai Disclosures.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.