소개
공식 Open API와 WTS 전용 기능을 함께 쓰는 토스증권 CLI·MCP 서버
공식 API로는 못 보는 토스증권 데이터까지, CLI와 MCP로. 실행 바이너리는 tossctl입니다.
공식 Open API의 계좌·시세·주문에 WTS 전용 수급·AI 시그널·배당·관심종목을 더합니다. 터미널·스크립트에서는 CLI로, AI 에이전트에서는 MCP로 사용합니다. 공식 키와 WTS 웹 세션은 서로 다른 인증이며, 기능별로 필요한 인증이 다릅니다.
비공식 프로젝트
토스증권 공식 제품이 아닙니다. 웹 내부 API를 비공식적으로 사용하며, 이용약관(TOS) 위반에 해당할 수 있습니다. API는 예고 없이 변경될 수 있고, 사용으로 인한 계좌 제한·손실·기타 불이익에 대해 개발자는 책임지지 않습니다. 본인의 판단과 책임 하에 사용하세요.
거래는 기본 비활성
설치 직후 모든 거래 기능이 꺼져 있습니다. config.json에서 기능별로 직접 허용해야만
실행되며, 실거래는 --execute + --confirm <token> 2단계를 거칩니다.
자세한 내용은 안전 모델 참고.
핵심 요약
- 공식 API와 WTS를 함께 사용합니다. 지원되는 조회는 기본적으로 공식 API 우선이며, WTS 전용 기능은 웹 세션이 필요합니다.
- 공식에 없는 기능: 수급·시장지수·지수 상세 시세·토스 AI 시그널·뉴스 브리핑·조건검색· 배당 내역·업종별 등락·커뮤니티 랭킹·관심종목 관리·거래 내역·SSE 푸시 등.
- 출력 형식: 표(table) · JSON · CSV · SSE — 자동화/에이전트 파이프라인에 바로 연결.
현재 대상은 토스증권입니다. 일반 토스뱅킹·카드 소비 내역은 미지원이며, 미국 옵션 모의투자는 별도 옵트인 기능입니다. 전체 비교는 지원 범위를 참고하세요.
설치 후 첫 조회
# 설치 (macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/JungHoonGhae/tossinvest-cli/main/install.sh | sh
# 환경 점검 → 로그인 → 첫 조회
tossctl doctor
tossctl auth login
tossctl account summary --output json