본문 바로가기
M MCP모아

MCP모아는 정보 제공 목적입니다. 보안·라이선스·동작 책임은 이용자에게 있습니다.

토스증권 CLI·MCP (tossctl) — 토스증권 비공식 CLI·MCP — 공식 Open API와 웹 내부 API로 시세·자산·주문 조회

JungHoonGhae/tossinvest-cli

토스증권을 터미널과 AI 에이전트에서 쓰는 비공식 CLI·MCP로, 공식 API에 없는 투자 정보까지 조회합니다.

실험적 사용 주의 ⚖ MIT API 키 필요 ★ 522 업데이트 2일 전
Claude Code Cursor Cline Codex 호환

설치

터미널에서 실행하세요. 기본은 이 프로젝트 전용(local, ~/.claude.json)으로 저장됩니다. 팀과 공유하려면 --scope project(프로젝트 루트 .mcp.json), 모든 프로젝트에서 쓰려면 --scope user 를 붙이세요. 확인: claude mcp list 또는 Claude Code 세션 안에서 /mcp

claude mcp add tossinvest -- tossctl mcp

이 MCP가 해결하는 문제

토스증권 공식 Open API는 시세·계좌·주문 위주라서 AI 시그널, 수급, 배당, 세금 자료처럼 앱에서 따로 확인하던 정보는 AI에 연결하기 어렵습니다. tossctl은 공식 API와 웹 내부 API를 하나의 CLI·MCP로 묶어 이런 정보를 AI 에이전트가 조회하게 합니다. 다만 웹 내부 API 부분은 비공식이므로 약관과 변경 위험을 이해하고 사용해야 합니다.

보안 점검

2026-11-16 점검
사용 주의

백도어·외부 유출은 없으나 토스증권 웹 내부 API를 비공식으로 쓰고(약관 위반 가능), 로그인 세션 쿠키와 공식 API 키를 로컬 평문 JSON에 저장하며 실주문이 가능한 도구입니다.

통과한 점검

  • 데이터·API키 외부 유출 없음
  • 악성 설치 스크립트 없음
  • 하드코딩 크리덴셜·백도어 없음
  • 임의 셸 실행 없음
  • 제3자 서버 경유 없음

유의사항

  • 신규 확인: `tossctl skill install` 은 에이전트가 읽는 스킬 파일(SKILL.md)을 ~/.claude/skills 에 쓰는 명령. 바이너리 내장본이라 외부 전송은 없고 내용은 안전 규칙 중심이나, 설치된 스킬은 이후 에이전트 행동 지침이 되므로 설치 전 내용을 확인할 것
  • 공식 Open API 외 기능은 토스증권 웹(WTS) 내부 API를 비공식으로 호출합니다. README가 이용약관 위반 가능성과 예고 없는 변경, 계좌 제한 위험을 직접 경고합니다.
  • 웹 로그인은 파이썬 auth-helper(Playwright)로 브라우저 세션을 받아, 쿠키·헤더·스토리지를 config 디렉터리의 session.json에 평문 JSON(권한 0600)으로 저장합니다. 입력한 이름·생년월일·휴대폰 번호는 환경변수로 헬퍼에 전달되고 저장하지 않는다고 안내됩니다.
  • 공식 Open API 키와 시크릿도 openapi-credentials.json에 평문 JSON(권한 0600)으로 저장하며, 환경변수 TOSSCTL_OPENAPI_KEY·SECRET으로 대체할 수 있습니다. 토큰 캐시는 별도 파일입니다.
  • 기본 설치는 curl로 받은 install.sh 실행입니다. 릴리스 바이너리와 sha256 체크섬을 내려받아 검증한 뒤 설치하고 playwright>=1.52,<2를 pip로 설치하며, 쓰기 권한이 없으면 sudo를 사용합니다. 코드 내 외부 실행은 고정 인자의 auth-helper 호출뿐이며 임의 셸 실행은 발견되지 않았습니다.
  • 주문·취소·정정이 가능하지만 기본 비활성이며 config 허용(place, sell, allow_live_order_actions), 미리보기, execute 플래그, 확인 토큰을 모두 요구합니다.
  • 작성자가 운영하는 중계 서버는 없고 사용자 기기에서 토스증권 도메인으로 직접 통신합니다. 하드코딩 크리덴셜은 발견되지 않았습니다.
  • MIT 라이선스, 최신 커밋 2026-11-09, CI·SECURITY.md 보유, 오픈 이슈 5건입니다.
  • skills/install.sh(curl|sh)는 main 브랜치의 raw 파일을 체크섬 없이 받아 스킬로 설치하므로 내장 설치(`tossctl skill install`)가 더 안전함
  • MCP 쪽은 list_operations/describe_operation/call_operation 3개 도구로 127개 오퍼레이션을 노출. 쓰기 계열(관심종목·가격알림·숨김·주문, openapi_ip_replace_current 로 Open API 허용 IP 교체 등)은 모두 preview 후 execute=true+confirm_token 필요

데이터·키 전송 대상

openapi.tossinvest.com (토스증권 공식 Open API)wts-api.tossinvest.com · wts-info-api.tossinvest.com · wts-cert-api.tossinvest.com (토스증권 웹 내부 API, 비공식)www.tossinvest.com (Playwright 로그인 화면)

GitHub 저장소 직접 점검 — README·매니페스트(package.json/pyproject)·서버 소스·설치 스크립트·패키지 레지스트리(npm/PyPI/JSR) 대조. 공개 소스 기준의 자동+수동 검토 의견이며 완전성·무오류를 보증하지 않습니다. 시점 이후 변경될 수 있습니다.

한국어 사용 예시

자산 변화와 배당 정리

내 전체 계좌 자산 변화와 받은 배당을 정리하고 보유 종목 뉴스도 함께 보여줘

종목 수급 확인

삼성전자(A005930)의 최근 투자자별 수급 흐름을 알려줘

주문 미리보기

AAPL 1주를 200달러에 매수하는 주문을 미리보기만 해줘

자주 묻는 질문

공식 제품인가요? 약관 위험은 없나요?

아닙니다. 토스증권 공식 제품이 아닌 비공식 프로젝트입니다. 공식 Open API 외 기능은 토스증권 웹 내부 API를 비공식적으로 사용하며, README는 이용약관 위반에 해당할 수 있고 예고 없이 변경될 수 있다고 경고합니다. 계좌 제한이나 손실 등 결과는 사용자 책임입니다.

어떻게 설치하고 로그인하나요?

install.sh(macOS/Linux) 또는 install.ps1(Windows)로 tossctl을 설치하고, claude mcp add tossctl tossctl mcp 명령으로 MCP를 등록합니다. 웹 세션 기능은 tossctl auth login --phone으로 휴대폰 승인 로그인을 하고, 공식 Open API는 tossctl openapi setup 또는 openapi login으로 키를 연결합니다.

AI가 마음대로 주문을 낼 수 있나요?

설치 직후 모든 거래 기능은 꺼져 있습니다. config.json에서 trading 항목을 명시적으로 허용해야 하고, 주문은 미리보기를 거쳐 execute 플래그와 확인 토큰을 함께 줘야 실행됩니다. README는 실제 주문을 사람이 검토·승인하고 실행하라고 안내합니다.

연동 API

토스증권 Open API 토스증권 WTS(웹 내부 API)

관련 MCP

한국투자증권 트레이딩 MCP

koreainvestment/open-trading-api

공식 실험적 사용 주의

한국투자증권 공식 OPEN API 기반 국내외 주식·선물옵션 시세·잔고·주문 MCP 서버

금융·DART·주식 한국투자증권 OPEN APIKIS Developers API 키 필요
★ 1,677 ↓ 80/주 2일 전
Claude Code Cursor Cline

키움증권 REST API MCP

java-jaydev/kiwoom-mcp

실험적 보안 점검 통과

키움증권 REST API로 현재가·호가·차트·계좌 잔고를 조회하는 읽기 전용 MCP 서버

금융·DART·주식 키움증권 REST API(OpenAPI) API 키 필요
★ 4 8개월 전
Claude Code Cursor Cline

한국 주식 MCP 서버

jjlabsio/korea-stock-mcp

실험적 보안 점검 통과

DART·KRX 공식 API로 한국 주식 분석을 AI와 함께 수행하는 MCP 서버

금융·DART·주식 DARTKRX 보통
★ 185 ↓ 177/주 3개월 전
Claude Code Cursor

관련 가이드

전체 MCP 가이드 보기 →

리뷰 · 후기

후기 내려받기(CSV)
–

0개의 후기

설치해보셨다면 다른 분들을 위해 평가를 남겨주세요.

아직 후기가 없습니다. 첫 후기를 남겨주세요!