토스증권 Open API용 MCP 서버
Project description
토스증권 MCP
토스증권 Open API를 MCP 도구로 노출하는 서버입니다. Claude 같은 AI 에이전트가 토스증권의 시세 조회·보유 종목·주문 기능을 도구로 사용할 수 있습니다.
실거래 경고: 주문 집행 툴은 실제 주문·실자금을 발생시킵니다. 기본값은 읽기 전용이며,
TOSS_ENABLE_TRADING=true일 때만 주문 집행 툴이 켜집니다.
할 수 있는 일
- 시세 — 현재가, 호가, 체결 내역, 캔들 차트, 상/하한가
- 종목·시장 — 종목 정보, 매수 유의사항, 환율, 국내·해외 장 운영시간
- 계좌·조회 — 계좌 목록, 보유 종목, 주문 내역, 매수 가능 금액, 매도 가능 수량, 수수료
- 주문 집행 (거래 활성화 시) — 주문 생성·정정·취소
빠른 시작
- 토스증권 OpenAPI 콘솔에서
client_id·client_secret발급 - 설정 후 실행:
cp .env.example .env # 발급받은 키 입력
uv sync
uv run tossinvest-mcp
설정할 수 있는 모든 값은 .env.example에 정리되어 있습니다.
Claude Code에 등록
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를 유지하고,
수정한 파일에는 변경 사실을 명시해야 합니다(출처 표시 의무).
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file tossinvest_mcp-0.1.0.tar.gz.
File metadata
- Download URL: tossinvest_mcp-0.1.0.tar.gz
- Upload date:
- Size: 52.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.18 {"installer":{"name":"uv","version":"0.11.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0c426f4f21ae71dcd8b5f0fd04c8bd9643121d9516ddd25809370393c6e22ddf
|
|
| MD5 |
ecd19f2f4fdb88fdce7d7df2bb7cc9fa
|
|
| BLAKE2b-256 |
e5fa0e5cdee97afeb5b4455e28b71802086f5ab62c773b91c1aed0b001bbc843
|
File details
Details for the file tossinvest_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: tossinvest_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 52.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.18 {"installer":{"name":"uv","version":"0.11.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
92a9e730337f97feac83b3d08c8af45a7b9be9f7c6e2d3ebb4ea29078f6a2763
|
|
| MD5 |
a34946d1b86135ecbac754196041b0d6
|
|
| BLAKE2b-256 |
5be397361a009d4f0132251c36889a3178219013281623c49c4f564ea50ea22a
|
