RedoxNet.Mcp.LsOpenApi 1.2.0

RedoxNet.Mcp.LsOpenApi

MCP server for the LS 증권 OpenAPI — exposes Korean stock market data as MCP tools so AI assistants can query quotes, charts, ETF data, market screeners, and index / industry / theme context in natural language, alongside a local-only portfolio module (multi-account holdings, watchlists, watched themes, JSON backup / restore).

Unofficial third-party MCP server. Not affiliated with or endorsed by LS Securities Co., Ltd. (LS증권). v0.x.x scope: read-only market data + local portfolio notes (manual entry; no broker sync, no order placement).

Install

Prerequisite. dnx is the dotnet tool launcher that ships with .NET SDK 10 or later. Install from .NET downloads if you don't have it yet. Verify with dnx --help.

dnx fetches the latest published version from NuGet on every launch — no separate install step. Wire it into your MCP host:

Claude Desktop / Claude Code

claude_desktop_config.json (Claude Desktop) or .mcp.json at your workspace root (Claude Code):

{
  "mcpServers": {
    "lsopenapi": {
      "command": "dnx",
      "args": ["RedoxNet.Mcp.LsOpenApi", "--yes"],
      "env": {
        "LS_APPKEY": "...",
        "LS_APPSECRETKEY": "...",
        "LS_MARKET": "real"  // default if omitted; use "virtual" only for LS mock accounts
      }
    }
  }
}

Codex CLI

%USERPROFILE%\.codex\config.toml (Windows) or ~/.codex/config.toml (macOS / Linux):

[mcp_servers.lsopenapi]
command = "dnx"
args = ["RedoxNet.Mcp.LsOpenApi", "--yes"]

[mcp_servers.lsopenapi.env]
LS_APPKEY = "..."
LS_APPSECRETKEY = "..."
LS_MARKET = "real"  # default if omitted; use "virtual" only for LS mock accounts

VS Code

Workspace .vscode/mcp.json:

{
  "servers": {
    "lsopenapi": {
      "type": "stdio",
      "command": "dnx",
      "args": ["RedoxNet.Mcp.LsOpenApi", "--yes"],
      "env": {
        "LS_APPKEY": "...",
        "LS_APPSECRETKEY": "...",
        "LS_MARKET": "real"  // default if omitted; use "virtual" only for LS mock accounts
      }
    }
  }
}

FieldCure AssistStudio

Settings → Connect → Add MCP Server, then fill the dialog:

LS_APPKEY=...
LS_APPSECRETKEY=...
LS_MARKET=real

AssistStudio renders the optional Plotly chart spec from ls_get_chart inline in the chat — call it with include_chart=true (single timeframe) to get a candlestick chart directly in the conversation.

Environment variables

Credentials are accepted only through the process environment — never through chat, tool arguments, or MCP elicitation. Prompting for them in conversation would either log them or train callers to share them in transcripts, so that input path is intentionally closed off.

Local data lives at %LOCALAPPDATA%\RedoxNet\LsOpenApi\ on Windows and ~/.local/share/redoxnet/lsopenapi/ on Linux/macOS: token.db (auth cache, SHA-256 keyed) and portfolio.db (user-supplied holdings/watchlists; never read or written by tools outside the portfolio family).

Tools (34 in the standard profile)

v0.10 (BREAKING) compresses the tool surface: the twenty v0.9 portfolio tools fold into five action-routed dispatchers (ls_account, ls_watchlist, ls_watched_themes, ls_portfolio_io, ls_holding), and the new LS_TOOL_PROFILE env var hides the three catalog tools in the default standard profile. Surface 48 → 32 (standard) / 35 (all). Additive in the same release: ls_get_stock_info gains an opt-in foreign ownership section (t1716); list / screener tools unify their row cap to limit and emit total_available; ls_get_index_history gains output_mode=export with a dataset_id drill.

Market data (LS-backed, credentials required)

ls_search_tr / ls_describe_tr / ls_call_tr are catalog tools — hidden in the default standard profile; set LS_TOOL_PROFILE=all to expose them.

Index + industry (LS-backed)

LS themes (LS-backed)

Screeners & per-stock analytics (LS-backed)

Program trading (LS-backed)

Portfolio (local-only, no broker sync)

Manual entries persisted to portfolio.db next to token.db. v0.10 folds the twenty v0.9 portfolio tools into five action-routed dispatchers — each takes an action argument and validates the per-action required parameters — plus two standalone tools. List responses fall back to a quote_error envelope when LS credentials are missing, but saved data still returns.

Ambiguity policy. Reads fall back; writes require an explicit target when ambiguous. 0 accounts → RequiresAccount; 1 account → auto with applied_to echo; 2+ → AmbiguousAccount with candidates[] so the model can re-call without prompting the user. Every mutation response includes applied_to (single account) or applied_to[] with before/after snapshots (corporate actions).

Error envelopes. RequiresAccount / AmbiguousAccount / AccountNotFound / RequiresConfirmation / InsufficientQuantity / ValidationError — all carry structured fields (candidates, identifier, holding count + market value, etc.) so the LLM can recover automatically.

Full release notes: https://github.com/redoxnet/mcp-lsopenapi/blob/main/RELEASENOTES.Mcp.md

Documentation & source

• Project home: https://github.com/redoxnet/mcp-lsopenapi
• TR inventory: https://github.com/redoxnet/mcp-lsopenapi/blob/main/docs/LS-TR-INVENTORY.md
• SDK package: https://www.nuget.org/packages/RedoxNet.LsOpenApi.Core/
• License: MIT