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

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

@migusdn

リポジトリ

한국투자증권 REST API MCP (Model Context Protocol) について

한국투자증권 mcp server

基本情報

カテゴリ

開発者ツール

ライセンス

MIT

ランタイム

python

トランスポート

stdio

公開者

migusdn

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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.

「開発者ツール」の他のコンテンツ

nuxt-mcp / vite-plugin-mcp

antfu

MCP server helping models to understand your Vite/Nuxt app better.

910

FastAPI-MCP

tadata-org

Expose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth!

11.9K

Unity MCP (Server + Plugin)

IvanMurzak

AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for fr

3.5K