K-invest

Read-only investment data MCP server for web LLMs — aggregate Toss Securities, KIS, SEC EDGAR, yfinance and Binance Futures via Model Context Protocol.

Overview

Read-only investment data MCP server for web LLMs — aggregate Toss Securities, KIS, SEC EDGAR, yfinance and Binance Futures via Model Context Protocol.

Repository: https://github.com/ianlyoo/K-invest — Pages: https://ianlyoo.github.io/K-invest/ — Language: Python — License: MIT

README (English) — README (한국어)

Features

  • Multi-provider: Toss Securities, KIS Open API, SEC EDGAR, yfinance, Binance USD-M Futures
  • MCP-compatible: FastMCP Streamable HTTP single /mcp endpoint
  • OAuth 2.1 + Bearer: Authorization Code + PKCE or static MCP_AUTH_TOKEN
  • Read-only safety: No order placement tools

Quick start

git clone https://github.com/ianlyoo/K-invest.git
cd K-invest
pip install -r requirements.txt
cp .env.example .env
python3 server.py

Providers are partially configurable. Expose via HTTPS with sslip.io + Caddy.

Tools

All tools return {ok, data, error, meta} envelope. See README tool catalog.

License and ownership

Owner: ianlyoo — License: MIT — Language: Python