# korea-stock-mcp

MCP server for korea stock

- **Type:** MCP server
- **Trust:** 85/100 (A), scored on the package rubric
- **Verification:** verified (build provenance)
- **Version:** 1.4.1
- **Author:** jjlabsio
- **License:** ISC
- **npm:** korea-stock-mcp
- **Source:** https://github.com/jjlabsio/korea-stock-mcp
- **Compatible clients:** claude-code, cursor, copilot, gemini (basis: transport)

## Trust

85/100 (A), scored on the package rubric
- Publisher verified: no
- Build provenance: verified attestation
- npm trusted publishing (OIDC): yes
- Install scripts: nothing suspicious found
- Prompt-injection scan: not run
- Obfuscation scan: not run
- Evidence age: 4 days

## Security scan

- **Status:** warnings
- **Scanned:** 2026-08-30T00:17:25.110Z
- **Version scanned:** 1.4.1
- **CVEs:** none found by OSV at scan time

## Tools

8 declared. Statically extracted from the shipped source — a floor on the surface, not a census.
- `get_corp_code` — 고유번호: DART에 등록되어있는 공시대상회사의 고유번호, 회사명, 종목코드를 제공합니다. 비상장법인도 조회 가능합니다. 회사명(corp_name, 한글 또는 영문) 또는 종목코드(stock_code) 중 하나로 조회할 수 있습니다. 회사명은 부분 일치 검색을 지원하므로 정확한 이름을 
- `get_disclosure_list` — 공시검색: 공시 유형별, 회사별, 날짜별 등 여러가지 조건으로 공시보고서 검색기능을 제공합니다. 최근 공시를 검색할때는 bgn_de를 반드시 지정하세요.
- `get_disclosure` — DART API를 통해 공시보고서 원본파일을 파싱해 가져옵니다. 문서가 큰 경우(1MB 초과) 목차(type: "toc")를 반환합니다. 목차가 반환되면 유저의 질문과 관련된 섹션을 section_id로 조회하세요. 답변 후, 조회하지 않은 나머지 섹션 목록을 유저에게 안내하여 추가 조
- `get_financial_statement` — 재무제표: 상장법인(유가증권, 코스닥) 및 주요 비상장법인(사업보고서 제출대상 & IFRS 적용)이 제출한 정기보고서 내에 XBRL재무제표의 모든계정과목을 제공합니다.
- `get_market_type` — DART에 등록되어 있는 종목의 상장시장 정보를 제공합니다. Y(유가), K(코스닥), N(코넥스), E(기타)
- `get_stock_base_info` — 코스피, 코스닥, 코넥스에 상장되어있는 종목의 기준일에 해당하는 한글 종목명, 영문 종목명, 상장일, 주식종류, 액면가, 상장주식수 등의 정보를 제공합니다. codeList에 종목코드가 포함된 종목들의의 정보만 추출됩니다. basDd 하나당 KRX API를 한번씩 호출합니다.
- `get_stock_trade_info` — 코스피, 코스닥, 코넥스에 상장되어있는 종목의 기준일에 해당하는 종가, 등락률, 시가, 고가, 저가, 거래량, 거대금, 시총액, 상장주식수 등의 정보를 제공합니다. codeList에 종목코드가 포함된 종목들의의 정보만 추출되어 제공됩니다. basDd 하나당 KRX API를 한번씩 호출합
- `get_today_date` — 오늘 날짜를 KST, UTC 기준 YYYYMMDD 형식으로 제공합니다.

## Install

**Verdict: install** — No blocking findings and no open coverage gaps — safe to install as configured.
**Config** (claude-code):
```json
"{\n  \"mcpServers\": {\n    \"korea-stock\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"korea-stock-mcp\"\n      ],\n      \"env\": {\n        \"DART_API_KEY\": \"<YOUR_DART_API_KEY>\",\n        \"KRX_API_KEY\": \"<YOUR_KRX_API_KEY>\"\n      }\n    }\n  }\n}"
```
**Credentials it will ask for** (names only — Forge never holds a value):
- `DART_API_KEY` — Dart API Key (required)
- `KRX_API_KEY` — Krx API Key (required)
Placeholders only. Forge never holds, brokers, or transmits a credential value — replace each <YOUR_NAME> in your own config file. Do not send a value back to Forge; no Forge endpoint accepts one.
- This entry needs 2 credentials (2 required). The generated config carries placeholders, so it will fail in the editor rather than at runtime if they are left unset.

## Blast radius

Moderate blast radius — holds an api key; runs on your machine.
- Floor 25, ceiling 25 (tier: moderate)
- This is impact, not likelihood. A high radius is not a defect: a filesystem server is supposed to write files. It is never part of the trust score.

## Machine-readable views of this entry

- Signed JSON: https://forgeregistry.com/api/v1/packages/korea-stock-mcp
- Install plan: https://forgeregistry.com/api/v1/packages/korea-stock-mcp/install-plan
- Alternatives: https://forgeregistry.com/api/v1/alternatives/korea-stock-mcp
- HTML page: https://forgeregistry.com/registry/korea-stock-mcp
- MCP: POST https://forgeregistry.com/api/mcp → `forge_get_package` / `forge_install_plan`

## About this document

Generated by Forge (https://forgeregistry.com) — a compact rendering of the same record served, signed, at the JSON URL above. Trust and scan facts are the registry's own measurements; anything Forge did not measure is named as unmeasured rather than omitted.