Tossinvest

PyPI Python License CI

토스증권 Open API를 MCP 도구로 노출하는 서버입니다. Claude 같은 AI 에이전트가 한국 주식(KRX) 시세/보유 종목/주문/기술적 분석을 도구로 사용할 수 있습니다.

English: MCP server exposing the Toss Securities (토스증권) Open API as tools for Claude and other AI agents. Covers Korean stock market (KRX) quotes, holdings, order execution, conditional orders (SINGLE/OCO/OTO), market rankings, index indicators, and a session-aware technical-analysis dashboard (MACD/RSI/Bollinger/VWAP). Read-only by default; opt-in trading. (Korean docs below.)

실거래 경고: 주문 실행 툴은 실제 주문/실자금을 발생시킵니다. 기본값은 읽기 전용이며, TOSS_ENABLE_TRADING=true일 때만 주문 실행 툴이 켜집니다.

할 수 있는 일

• 시세: 현재가, 호가, 체결 내역, 캔들 차트, 상/하한가
• 종목/시장: 종목 정보, 매수 유의사항, 환율, 국내/해외 장 운영시간
• 랭킹/지표: 거래대금/거래량/등락률 랭킹, 시장 지표(국내 지수·국채 시세/캔들/투자자별 매매대금)
• 기술적 분석: 지표 대시보드(이동평균/MACD/RSI/볼린저밴드/ATR/OBV/MFI 등), 장중 VWAP, 호재/악재 데이터 신호
• 계좌/조회: 계좌 목록, 보유 종목, 주문·조건주문 내역, 매수 가능 금액, 매도 가능 수량, 수수료
• 주문 실행 (거래 활성화 시): 주문 생성/정정/취소, 조건주문 등록/수정/취소 (단일·OCO·OTO)
• 워크플로 프롬프트: 포트폴리오 분석, 차트 분석, 매수 전 체크리스트 등 바로 쓰는 분석 템플릿

빠른 시작

1. 토스증권 OpenAPI 콘솔에서 client_id/client_secret 발급
2. 설정 후 실행:

cp .env.example .env   # 발급받은 키 입력
uv sync
uv run tossinvest-mcp

설정할 수 있는 모든 값은 .env.example에 정리되어 있습니다.

Claude Code에 등록

추천: uvx (설치/클론 없이 어디서나)

uvx로 바로 실행할 수 있습니다. 자격증명은 --env로 전달하므로 .env 파일이 필요 없습니다:

claude mcp add tossinvest \
  --env TOSS_CLIENT_ID=발급받은_CLIENT_ID \
  --env TOSS_CLIENT_SECRET=발급받은_CLIENT_SECRET \
  -- uvx tossinvest-mcp

주문 실행까지 쓰려면 --env TOSS_ENABLE_TRADING=true를 추가하세요.

로컬 체크아웃 (개발용)

저장소를 클론해 수정하며 쓸 때. 자격증명은 .env로 설정합니다:

claude mcp add tossinvest -- uv --directory /path/to/tossinvest-mcp run tossinvest-mcp

거래 활성화

기본은 안전하게 읽기 전용입니다. 주문 실행까지 쓰려면 .env에 추가하세요:

TOSS_ENABLE_TRADING=true

AI가 직접 실주문을 낼 수 있으니 신뢰할 수 있는 환경에서만 켜세요.

테스트

uv run pytest -m "not e2e"

라이선스

Apache-2.0

NOTICE