Korea Stock MCP

🚀 Korea Stock MCP Server

This is an MCP server for analyzing Korean stocks. It enables AI - powered analysis of stock prices and disclosure data through the official APIs of DART (Data Analysis, Retrieval and Transfer System) and KRX (Korea Exchange).

🚀 Quick Start

1️⃣ API KEY Registration

First, you need to obtain API KEYs from both DART and KRX.

📝 DART API KEY Registration

1. Sign Up: Register at OPEN DART.
2. Request Key: Apply for an API KEY at Authentication Key Application Page.
3. Check Key: Verify the issued API KEY at Open API Usage Status.

📈 KRX API KEY Registration

1. Sign Up: Register and log in at KRX OPEN API.

2. Request Key: Apply for an API authentication key in My Page → API Authentication Key Application.

3. Service Application: After approval, go to Service Use → Stock menu.

4. API Usage Application: Click "API Usage Application" for each of the following 6 items:

   • Securities Daily Trading Information
   • KOSDAQ Daily Trading Information
   • KONEX Daily Trading Information
   • Securities Basic Information
   • KOSDAQ Basic Information
   • KONEX Basic Information

   ⏱️ Approval takes approximately 1 day.

5. Key Verification: After approval, check the API KEY in My Page → API Authentication Key Issuance History.

2️⃣ Claude Desktop Setup

1. Launch Claude Desktop.
2. Go to Settings → Developer → Edit Configuration.
3. Add the following content 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>"
      }
    }
  }
}

4. Restart: Restart Claude Desktop to apply the settings.

You can now start analyzing Korean stock data with Claude.

✨ Features

• 🔍 Disclosure Search - Search corporate disclosures by company and date.
• 📊 Disclosure Data - Provides parsed data from original disclosure reports.
• 💼 Financial Statement Analysis - Detailed financial data based on XBRL.
• 📈 Stock Data - KRX (KOSPI/KOSDAQ) daily stock prices and basic stock information.

💻 Usage Examples

📊 Financial Analysis Examples

Prompt: "Investigate Samyang Foods's sales and operating profit for Q1 - Q4 2023, Q1 - Q4 2024, and Q1 - Q2 2025, and also check growth rates"
→ See Samyang Foods Analysis Results

Prompt: "Investigate APR's sales and operating profit growth from Q1 2023 to Q2 2025, along with stock price and market cap trends"
→ See APR Analysis Results

🏢 Corporate Analysis Examples

Prompt: "Tell me what HJ SHIPBUILDING & CONSTRUCTION does to make money and include sales by business segment"
→ See HJ SHIPBUILDING & CONSTRUCTION Analysis Results

📚 Documentation

Available Tools

DART (Data Analysis, Retrieval and Transfer System)

1. get_disclosure_list - Disclosure Search
   • Search disclosure reports by type, company, and date.
2. get_corp_code - Corporate Code Inquiry
   • Provides unique codes, company names, and stock codes of DART - registered disclosure companies.
3. get_disclosure - Disclosure Report Content
   • Parse original disclosure report files through the DART API.
4. get_financial_statement - Financial Statements
   • XBRL financial statements for listed and major unlisted companies.
   • Provides all account data from periodic reports.

KRX (Korea Exchange)

1. get_stock_base_info - Basic Stock Information
   • Basic information for KOSPI, KOSDAQ, and KONEX listed stocks.
   • Basic data including stock names, codes, and market classifications.
2. get_stock_trade_info - Daily Trading Information
   • Daily trading data for KOSPI, KOSDAQ, and KONEX stocks.
   • Detailed trading information including stock prices, trading volume, and market capitalization.
3. get_market_type - Market Type Inquiry
   • Query market classification (KOSPI/KOSDAQ/KONEX) by stock code.
   • Provides market information needed for stock data queries.

Other Tools

1. get_today_date - Today's Date Inquiry
   • Provides the current date in YYYYMMDD format.
   • A tool for AI's accurate date inquiry.

API Data Sources

• DART (Data Analysis, Retrieval and Transfer System): Listed company disclosure information and financial statements.
• KRX (Korea Exchange): Basic stock information and daily trading information.

🤝 Contributing

Contributions are welcome! Please send us a Pull Request.

1. Fork this repository.
2. Create a feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

📄 License

ISC License

🛠️ Support

• 🐛 If you have issues, please register them in GitHub Issues.
• ⭐ If you find it useful, please give it a star!

⚠️ Disclaimer

This tool is for informational purposes only and is not investment advice. All investment decisions are your own responsibility.