kospi-kosdaq-stock-server
Provides an MCP (FastMCP) server that fetches KOSPI/KOSDAQ stock data (tickers, OHLCV, market cap, fundamentals, investor-type trading volume) and KOSPI/KOSDAQ index OHLCV from KRX Data Marketplace. Uses Kakao OAuth with Playwright for authentication and maintains/refreshes a session cookie.
Score Breakdown
⚙ Agent Friendliness
🔒 Security
Uses browser-based Kakao login with stored session cookies; README instructs users to provide KAKAO_ID/KAKAO_PW via environment variables. It does not describe how credentials/cookies are stored securely (e.g., encryption, file permissions, logging redaction) or what network/TLS assurances exist internally. Security posture may be weaker than token-based server-to-server APIs, and the headless browser increases attack surface. Also, the tool assumes Kakao 2FA is disabled, increasing account risk if credentials are mishandled.
⚡ Reliability
Best When
You want agent-friendly access to KOSPI/KOSDAQ market data via MCP tools, and you can provide Kakao credentials (with 2FA disabled) and run Playwright/Chromium.
Avoid When
You cannot handle interactive/automated login approval flows, or you require strict security controls around credentials and headless browser automation, or you need a purely server-to-server auth model (no browser-based login).
Use Cases
- • Programmatic retrieval of Korean stock OHLCV time series (daily/monthly/yearly for indices)
- • Enriching datasets with market cap and fundamental ratios (PER/PBR/dividend yield)
- • Analyzing investor-type trading volume for KOSPI/KOSDAQ stocks
- • Building agent workflows that need a tool-based interface for market data lookup and download of ticker metadata
Not For
- • Use as a production-grade financial data API without reviewing compliance and access constraints
- • Accounts requiring Kakao 2FA (not supported per README)
- • Workloads that cannot tolerate Playwright/Chromium runtime dependencies
- • Use cases needing fine-grained rate-limit guarantees or documented SLAs
Interface
Authentication
Authentication is implemented via Kakao login using Playwright and a saved session cookie; Kakao 2FA must be disabled per README. No OAuth scopes mentioned (no token-scope model described).
Pricing
No pricing model for the MCP server itself is stated in the provided README content. Access to KRX Data Marketplace may have its own costs/entitlements beyond this tool.
Agent Metadata
Known Gotchas
- ⚠ Requires Kakao 2FA disabled; first login may require user approval via KakaoTalk
- ⚠ Session cookie expires (~4 hours); failures may require deleting ~/.krx_session.json and restarting
- ⚠ Playwright/Chromium dependencies and Linux system libraries can be required for headless operation
Alternatives
Full Evaluation Report
Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for kospi-kosdaq-stock-server.
AI-powered analysis · PDF + markdown · Delivered within 30 minutes
Package Brief
Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.
Delivered within 10 minutes
Score Monitoring
Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.
Continuous monitoring
Scores are editorial opinions as of 2026-03-30.