home / mcp / korea stock mcp server

Korea Stock MCP Server

MCP Server for Korean stock analysis. 한국 주식 분석을 위한 MCP 서버입니다.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "jjlabsio-korea-stock-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "korea-stock-mcp@latest"
      ],
      "env": {
        "KRX_API_KEY": "<YOUR_KRX_API_KEY>",
        "DART_API_KEY": "<YOUR_DART_API_KEY>"
      }
    }
  }
}

The Korea Stock MCP Server provides AI-powered analysis of Korean stock data by combining official data sources from DART and KRX. You can search disclosures, parse financial reports, analyze financial statements, and retrieve stock basics and daily trading information to make informed insights.

How to use

You connect an MCP client to the Korea Stock MCP Server to run analyses. Start by ensuring you have API keys from both DART and KRX, configure the MCP server in your client, and then prompt the AI to fetch and analyze data such as disclosures, XBRL financials, and daily stock information. Use prompts that request specific time ranges, company names, or data types (e.g., disclosures by date, quarterly financials, or daily stock prices). The server exposes tools to search disclosures, fetch financial statements, retrieve stock basics, and obtain daily trading data, enabling end-to-end analyses from source to insights.

How to install

Prerequisites: you need Node.js installed on your machine, and access to a Claude Desktop environment for MCP integration. You will also need API keys from DART and KRX to enable live data access.

1) Prepare API keys. Acquire your DART API KEY and KRX API KEY before configuring the MCP server.

2) Configure Claude Desktop to load the Korea Stock MCP Server. Open Claude Desktop settings and add the following configuration snippet to 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>"
      }
    }
  }
}

Additional setup details

After saving the configuration, restart Claude Desktop to apply the settings. With the MCP server loaded, you can start asking the AI to perform disclosures searches, retrieve financial statements, or fetch stock data and perform analyses.

Notes and best practices

- Verify your DART and KRX API keys are active and have the necessary permissions for the data you request. - Structure your prompts to specify company names, date ranges, and data types to reduce ambiguity and improve result quality. - Keep your API keys secure and avoid sharing them in plaintext.

Troubleshooting

If data retrieval fails, check that API keys are correctly set in Claude Desktop and that they are still valid. Ensure your Claude Desktop is restarted after configuration changes. Review any error messages from the MCP client for hints about missing permissions or invalid keys.

Security and usage notes

This MCP server is designed to provide data access and analysis capabilities only. Do not rely on it for investment advice. Treat API keys as secrets and rotate them if you suspect exposure.

Available tools

get_disclosure_list

Search disclosures by type, company, and date.

get_corp_code

Retrieve corporate codes for DART-registered companies.

get_disclosure

Fetch and parse original disclosure reports from DART.

get_financial_statement

Access XBRL-based financial statements for listed and major unlisted entities.

get_stock_base_info

Get basic stock information for KOSPI, KOSDAQ, and KONEX.

get_stock_trade_info

Retrieve daily trading information including price, volume, and market cap.

get_market_type

Query market type by stock code.

get_today_date

Return the current date in YYYYMMDD format.