Toss Invest

토스증권 Open API를 위한 MCP (Model Context Protocol) 서버입니다.

요구사항

• Node.js 18+
• 토스증권 WTS에서 발급받은 client_id, client_secret

설치 및 빌드

npm install
npm run build

환경변수

변수명	설명	필수
TOSS_CLIENT_ID	토스증권 Open API Client ID	✅
TOSS_CLIENT_SECRET	토스증권 Open API Client Secret	✅

Claude Desktop 설정

~/.claude/claude_desktop_config.json (또는 Claude Desktop > 설정 > MCP):

{
  "mcpServers": {
    "toss-invest": {
      "command": "node",
      "args": ["/Volumes/data/Github/stock-toss-mcp/dist/index.js"],
      "env": {
        "TOSS_CLIENT_ID": "여기에_client_id",
        "TOSS_CLIENT_SECRET": "여기에_client_secret"
      }
    }
  }
}

제공 도구

시장 데이터

도구	설명
toss_get_orderbook	호가 조회
toss_get_prices	현재가 조회 (최대 200개 종목)
toss_get_trades	최근 체결 내역 조회
toss_get_price_limits	상/하한가 조회
toss_get_candles	캔들 차트 조회 (1분봉/일봉)

종목 정보

도구	설명
toss_get_stocks	종목 기본 정보 조회 (최대 200개)
toss_get_stock_warnings	종목 매수 유의사항 조회

시장 정보

도구	설명
toss_get_exchange_rate	KRW↔USD 환율 조회
toss_get_kr_market_calendar	국내 장 운영 시간 조회
toss_get_us_market_calendar	미국 장 운영 시간 조회

계좌 및 자산

도구	설명
toss_get_accounts	계좌 목록 조회
toss_get_holdings	보유 주식 조회
toss_get_buying_power	매수 가능 금액 조회
toss_get_sellable_quantity	판매 가능 수량 조회
toss_get_commissions	매매 수수료 조회

주문 (⚠️ 실거래)

도구	설명
toss_get_orders	주문 목록 조회
toss_get_order	주문 상세 조회
toss_create_order	주문 생성 (실거래)
toss_modify_order	주문 정정 (실거래)
toss_cancel_order	주문 취소 (실거래)

⚠️ toss_create_order, toss_modify_order, toss_cancel_order는 실제 계좌에서 거래가 발생합니다.