Kiwoom Securities MCP Server

stdio

Read-only MCP server for the Kiwoom Securities REST API: market data, account inquiry, ISA tax tool

Getting Started

npx @getmcp/cli add io.github.ChunSam/kiwoom-mcp-server

Requires Node.js 18+. Community-contributed server. Review source before installing.

Claude Desktopguide →Vscodeguide →Cursorguide →Windsurfguide →

Required Environment Variables

KIWOOM_APP_KEY
Kiwoom REST API app key (issued at openapi.kiwoom.com; VIRTUAL and REAL need separate keys)
KIWOOM_APP_SECRET
Kiwoom REST API app secret

Configuration

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

JSON

{
  "mcpServers": {
    "io.github.ChunSam/kiwoom-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "kiwoom-mcp-server"
      ],
      "env": {
        "KIWOOM_APP_KEY": "",
        "KIWOOM_APP_SECRET": "",
        "KIWOOM_MODE": "VIRTUAL",
        "ISA_ENABLED": "false"
      }
    }
  }
}

Claude Desktop MCP documentation