kospi-kosdaq-stock-serverSAFE
An MCP server that provides KOSPI/KOSDAQ stock data using FastMCP
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
[](https://mseep.ai/app/dragon1086-kospi-kosdaq-stock-server)
[](https://badge.fury.io/py/kospi-kosdaq-stock-server) [](https://smithery.ai/server/@dragon1086/kospi-kosdaq-stock-server)
An MCP server that provides KOSPI/KOSDAQ stock data from KRX Data Marketplace.
What's New in v0.3.0
Since December 27, 2024, KRX Data Marketplace requires Kakao/Naver login for data access. This version implements:
- Direct KRX API integration with Kakao OAuth login
- Playwright-based headless browser for authentication
- Automatic session management with 4-hour timeout and auto re-login
- No more pykrx dependency for core functionality
Features
- Lookup KOSPI/KOSDAQ ticker symbols and names
- Retrieve OHLCV (Open/High/Low/Close/Volume) data for stocks
- Retrieve market capitalization data
- Retrieve fundamental data (PER/PBR/Dividend Yield)
- Retrieve trading volume by investor type (institutional, foreign, individual)
- Retrieve index OHLCV data (KOSPI, KOSDAQ indices)
Requirements
- Python 3.10+
- Kakao account (2FA must be disabled)
- Playwright Chromium browser
Environment Variables
# Required: Kakao login credentials KAKAO_ID=your_kakao_id KAKAO_PW=your_kakao_password
Important: Your Kakao account must have 2-step verification (2FA) disabled. On first login, you may need to approve the login request via KakaoTalk.
Installation
Prerequisites
# Install Playwright and Chromium browser pip install playwright playwright install chromium
Installing via Smithery
088621b2e0deOBSERVED · 2026-10-07Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add kospi-kosdaq-stock-server -- uvx kospi-kosdaq-stock-server
{
"mcpServers": {
"kospi-kosdaq-stock-server": {
"command": "uvx",
"args": [
"kospi-kosdaq-stock-server"
]
}
}
}Exposed tools (7)
7 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
get_index_ohlcv | read | Retrieves OHLCV data for a specific index. |
get_sector_info | read | Retrieves sector/industry classification for all stocks in a market. |
get_stock_fundamental | read | Retrieves fundamental data (PER/PBR/Dividend Yield) for a specific stock. |
get_stock_market_cap | read | Retrieves market capitalization data for a specific stock. |
get_stock_ohlcv | read | Retrieves OHLCV (Open/High/Low/Close/Volume) data for a specific stock. |
get_stock_trading_volume | read | Retrieves trading volume by investor type for a specific stock. |
load_all_tickers | read | Loads all ticker symbols and names for KOSPI and KOSDAQ into memory. |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | WARN |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- none-observed
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (3)
.DS_Store
.DS_Store
requests, pandas, mcp, playwright, nest-asyncio, holidays
Gates applied: no_behavioural_pass.
088621b2e0defull audit observations/trust-audit/mcp-server/dragon1086__kospi-kosdaq-stock-data.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-07 | 088621b2e0de | SAFE | B | 89 | first audit |
Questions
What is the KOSPI/KOSDAQ Stock Data MCP server?
An MCP server that provides KOSPI/KOSDAQ stock data using FastMCP
What tools does KOSPI/KOSDAQ Stock Data expose?
7 in total: 7 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is KOSPI/KOSDAQ Stock Data safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.
What credentials does KOSPI/KOSDAQ Stock Data need?
No credential environment variables were found in its source, so it appears to need none.
How current is this page?
The grade is for one exact copy of the source (088621b2e0de), read on 2026-10-07. The repository is watched and re-audited when it changes.