How do I use KIS MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@KIS MCP Server what's the current price of Samsung Electronics (005930)?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

한국투자증권 KIS MCP Server

한국투자증권 Open API를 Claude에서 직접 사용할 수 있는 MCP 서버입니다.

사전 준비

KIS Developers 에서 앱키/앱시크리트 발급
Node.js 22+ 및 npm 설치

Related MCP server: Stock MCP Server

환경변수 설정

# 실전투자 (필수)
export KIS_APP_KEY="your_app_key"
export KIS_APP_SECRET="your_app_secret"
export KIS_ACCOUNT_NO="12345678"     # 계좌번호 앞 8자리
export KIS_ACCOUNT_PROD="01"         # 계좌상품코드 (기본값: 01)

# 모의투자 (선택)
export KIS_PAPER_APP_KEY="your_paper_app_key"
export KIS_PAPER_APP_SECRET="your_paper_app_secret"
export KIS_PAPER_ACCOUNT_NO="12345678"

빌드 및 실행

npm install
npm run build

Claude Code 설정 (.mcp.json)

프로젝트 루트 또는 ~/.claude/ 에 추가:

{
  "mcpServers": {
    "kis": {
      "command": "node",
      "args": ["/path/to/koreainvestment-mcp/dist/index.js"],
      "env": {
        "KIS_APP_KEY": "your_app_key",
        "KIS_APP_SECRET": "your_app_secret",
        "KIS_ACCOUNT_NO": "12345678",
        "KIS_PAPER_APP_KEY": "your_paper_app_key",
        "KIS_PAPER_APP_SECRET": "your_paper_app_secret",
        "KIS_PAPER_ACCOUNT_NO": "12345678"
      }
    }
  }
}

개발 중에는 tsx로 직접 실행 가능:

{
  "mcpServers": {
    "kis": {
      "command": "npx",
      "args": ["tsx", "/path/to/koreainvestment-mcp/src/index.ts"],
      "env": { "...": "..." }
    }
  }
}

제공 도구 (12개)

도구	설명	읽기전용
`kis_get_domestic_stock_price`	국내주식 현재가 조회	✅
`kis_get_domestic_stock_chart`	국내주식 일/주/월별 시세	✅
`kis_get_domestic_balance`	국내주식 잔고 조회	✅
`kis_get_account_assets`	투자계좌 자산 현황 (실전 전용)	✅
`kis_place_domestic_order`	국내주식 현금 주문	❌
`kis_revise_or_cancel_domestic_order`	국내주식 주문 정정/취소	❌
`kis_get_overseas_stock_price`	해외주식 현재가 조회	✅
`kis_get_overseas_stock_chart`	해외주식 일/주/월별 시세	✅
`kis_get_overseas_balance`	해외주식 잔고 조회	✅
`kis_place_overseas_order`	해외주식 주문	❌
`kis_search_stock`	종목코드·종목명 검색	✅
`kis_master_status`	종목 마스터 DB 현황	✅

주의사항

env="real" 주문 도구는 실제 자금이 사용됩니다. 테스트는 반드시 env="demo"를 사용하세요.
주문 도구의 기본값은 env="demo"(모의투자)로 설정되어 있습니다.
실전투자와 모의투자의 앱키/계좌번호는 별개입니다.
토큰은 프로세스 메모리에 캐시되며 만료 5분 전에 자동 재발급됩니다.
종목 마스터 데이터는 ~/.kis_mcp/master.db에 저장되며 하루 1회 자동 갱신됩니다.

This server cannot be installed

F

license - not found

-

quality - not tested

C

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

KIS MCP Server