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

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.

What are the minimum Python and dependency requirements?

Python >= 3.13 and uv are required. Install dependencies with uv sync.