KIS MCP Server

한국투자증권(KIS) REST API를 MCP 도구로 호출하는 서버입니다. 국내/해외 주식 조회, 계좌 조회, 주문 관련 API를 카탈로그 기반 범용 도구와 자주 쓰는 편의 도구로 제공합니다.

Local serverstdioPython

What is the KIS MCP server?

한국투자증권(KIS) REST API를 MCP 도구로 호출하는 서버입니다. 국내/해외 주식 조회, 계좌 조회, 주문 관련 API를 카탈로그 기반 범용 도구와 자주 쓰는 편의 도구로 제공합니다. Exposed over MCP by the kis mcp server, that capability becomes something an assistant can invoke while it works, not something you go and do afterwards.

Adding it to your client

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

Its toolset

Everything the assistant can do here goes through one of these:

  • auth — 인증
  • domestic_stock — 국내주식
  • overseas_stock — 해외주식
  • domestic_bond — 국내채권
  • domestic_futureoption — 국내선물옵션
  • overseas_futureoption — 해외선물옵션
  • elw — ELW
  • etfetn — ETF/ETN

Configuration

You will need 4 environment variables: KIS_MCP_TOOLSET, KIS_MCP_LOG_LEVEL, KIS_APP_KEY, KIS_APP_SECRET. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the kis mcp server does with a few real requests.

When to reach for it

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. KIS's toolset — auth, domestic_stock, overseas_stock and 5 more — is a fair guide to whether it matches your workflow. It is maintained by migusdn; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Available tools

ToolWhat it does
auth인증
domestic_stock국내주식
overseas_stock해외주식
domestic_bond국내채권
domestic_futureoption국내선물옵션
overseas_futureoption해외선물옵션
elwELW
etfetnETF/ETN

How to install the KIS MCP server

{
  "mcpServers": {
    "kis-mcp-server": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "<project-root>",
      "env": {
        "KIS_MCP_TOOLSET": "catalog",
        "KIS_MCP_LOG_LEVEL": "WARNING"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
KIS_MCP_TOOLSETConfiguration value read at startup.Optional
KIS_MCP_LOG_LEVELConfiguration value read at startup.Optional
KIS_APP_KEYCredential the server authenticates with.Yes
KIS_APP_SECRETCredential the server authenticates with.Yes

Example prompts to try

  • Use KIS to auth.
  • Use KIS to domestic stock.
  • Use KIS to overseas stock.

Frequently asked questions

It connects KIS to MCP-compatible AI assistants such as Claude and Cursor, exposing 8 tools (auth, domestic_stock, overseas_stock, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with KIS directly.