한국투자증권 REST API MCP (Model Context Protocol)

Name: 한국투자증권 REST API MCP (Model Context Protocol)
Author: migusdn

@migusdn

Repository

About 한국투자증권 REST API MCP (Model Context Protocol)

한국투자증권 mcp server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "KIS_MCP_Server": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is 한국투자증권 REST API MCP (Model Context Protocol)?

A server that exposes Korea Investment & Securities (KIS) REST APIs as MCP tools. It provides catalog-based general tools and convenience tools for domestic/overseas stock inquiry, account inquiry, and order placement. Designed for developers and traders using MCP-compatible clients.

How to use 한국투자증권 REST API MCP (Model Context Protocol)?

Install dependencies with uv sync, create a .env file with KIS_APP_KEY, KIS_APP_SECRET, KIS_CANO, KIS_ACNT_PRDT_CD, and optionally KIS_ENABLE_TRADING for order APIs. Run with uv run python server.py. Configuration can also be provided via command-line arguments. Supports stdio, sse, and streamable-http transports.

Key features of 한국투자증권 REST API MCP (Model Context Protocol)

166 REST APIs across 8 groups (stock, bond, futures, etc.)
Catalog-based tools: list-kis-api-specs, get-kis-api-spec, call-kis-api
Convenience tools for frequently used domestic/overseas stock functions
Automatic account number and token caching
Safety gate blocks trading APIs by default
Supports stdio, sse, streamable-http transports
Lightweight catalog mode reduces MCP tool context usage

Use cases of 한국투자증권 REST API MCP (Model Context Protocol)

Query domestic stock current price (e.g., Samsung Electronics)
Retrieve domestic stock balance and order history
Place buy/sell orders for domestic or overseas stocks
Check overseas stock balance and purchasable amount
Automate portfolio monitoring with AI assistants

FAQ from 한국투자증권 REST API MCP (Model Context Protocol)

How do I enable trading (order) APIs?

Set the environment variable KIS_ENABLE_TRADING=true before running the server. Without this, all order, correction, and cancellation APIs are blocked.

What transports are supported?

The server supports stdio (default), sse, and streamable-http transports. Use MCP_TYPE=sse or MCP_TYPE=streamable-http to switch, along with MCP_HOST, MCP_PORT, and MCP_PATH as needed.

What is the `catalog` toolset mode?

Setting KIS_MCP_TOOLSET=catalog exposes only three catalog tools (list-kis-api-specs, get-kis-api-spec, call-kis-api), reducing context usage while still allowing access to all 166 APIs via the generic call-kis-api tool.

Is this an official Korea Investment & Securities product?

No. This is an unofficial community open-source project. It is not affiliated with, endorsed by, or sponsored by KIS, KIS Developers, or true friend 한국투자증권 Open API.