{"id":"dragon1086-kospi-kosdaq-stock-server","name":"kospi-kosdaq-stock-server","homepage":null,"repo_url":"https://github.com/dragon1086/kospi-kosdaq-stock-server","category":"ai-ml","subcategories":[],"tags":["mcp","fastmcp","stock-market-data","krx","kospi","kosdaq","playwright","python","finance"],"what_it_does":"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.","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"],"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).","alternatives":["Other market-data APIs/SDKs that offer server-side API keys and documented rate limits (non-browser auth)","Python finance libraries that rely on public/less restricted data sources (may have coverage/accuracy differences)","Direct vendor integrations if KRX provides supported API keys/tokens for your account"],"af_score":50.2,"security_score":48.0,"reliability_score":46.2,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:53:51.668778+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":["python"],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Kakao OAuth via Playwright headless browser (cookie/session based)"],"oauth":true,"scopes":false,"notes":"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":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"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."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":50.2,"security_score":48.0,"reliability_score":46.2,"mcp_server_quality":78.0,"documentation_accuracy":70.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":35.0,"rate_limit_clarity":10.0,"tls_enforcement":65.0,"auth_strength":55.0,"scope_granularity":20.0,"dependency_hygiene":55.0,"secret_handling":45.0,"security_notes":"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.","uptime_documented":0.0,"version_stability":55.0,"breaking_changes_history":70.0,"error_recovery":60.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"none","retry_guidance_documented":false,"known_agent_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"]}}