Advertise
MCP.so
Sign In

한국투자증권 REST API MCP (MCP)

@migusdn

Repository

Basic information

Category

Developer Tools

Last updated

License

MIT

Transports

stdio

Author

migusdn

About 한국투자증권 REST API MCP

한국투자증권 mcp server

한국투자증권 REST API MCP config

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

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

한국투자증권 REST API MCP tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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

Frequently asked questions

1

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.

2

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.

3

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.

4

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.

5

What are the minimum Python and dependency requirements?

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

Comments

More Developer Tools MCP servers

offprompt

offprompt

MCP server that lets Claude Code, Cursor or Codex ask you for API keys on a local page and write them to .env. The agent only ever sees key names.

2

Mokxi

Build Arduino, ESP32 and Pico circuits with code from your AI assistant. Mokxi checks the circuit and hands back a link that opens and runs it in the browser simulator.

OhMyBug

OhMyX-AI

Code review for your coding agent's changes: a cloud bug hunt. #1 on the open ReviewBench. From $4; $0 if clean or minor-only. Works with Claude Code and Codex.

Capgo MCP

Cap-go

Console, Backend and CLI to manage Capgo Instant update and Native build for Capacitor apps Build and upload to app store your mobile app

FARPY

mangomunchr

Verified distributed compute for humans, applications, and agents. Submit Blender, Octane, and video workloads, route them across qualified GPUs, track asynchronous execution, download finished artifacts, and verify FARP

1
Advertise