tossinvest-openapi-mcp
토스증권 Open API를 개발자와 AI 에이전트가 쉽게 탐색·연동할 수 있도록 돕는 MCP(Model Context Protocol) 서버.
언어: 한국어 · English · 日本語
이 서버는 토스증권 OpenAPI(Toss Securities Open API, 토스증권 오픈API) 명세를 내장하여 MCP 도구로 제공합니다. 읽기 전용 문서/탐색 서버로, 실제 API를 호출하거나 주문을 실행하지 않으며 어떤 인증 정보도 필요로 하지 않습니다. Claude·Cursor·Codex 등 MCP를 지원하는 AI 코딩 에이전트에 연결한 뒤 "토스증권 API로 주문을 어떻게 넣어?" 같이 물어보면, 명세에 근거한 정확한 답변과 코드 샘플을 얻을 수 있습니다.
토스증권 Open API 연동을 처음 시작하는 개발자가 엔드포인트·인증·주문/시세 API 구조를 빠르게 파악하고, AI 에이전트로 코드를 생성하는 데 활용할 수 있습니다.
개요
MCP 클라이언트에 연결하면 에이전트는 다음을 할 수 있습니다.
- 토스증권 Open API의 모든 엔드포인트·카테고리 탐색
- 요청/응답 스키마와 예시 조회
- 키워드로 엔드포인트·데이터 모델 검색
- 유스케이스 중심 연동 가이드(인증, 시세, 주문 등) 활용
- curl / TypeScript / Python 요청 코드 샘플 생성
⚠️ 주의: 이 도구는 토스증권 공개 OpenAPI 문서를 설명하는 비공식 도구입니다. 실제 매매 실행, 계좌 접근, 인증 정보 전송을 하지 않습니다. 운영 적용 전 반드시 토스증권 Open API 공식 문서로 검증하세요.
제공 도구
| 도구 | 용도 |
|---|---|
get_api_overview |
API 전체 개요 (여기서 시작) |
list_categories |
카테고리(태그) 목록과 설명 |
list_endpoints |
엔드포인트 목록 (카테고리 필터 가능) |
search_endpoints |
키워드 기반 엔드포인트 검색 |
get_endpoint |
단일 엔드포인트 상세(파라미터·본문·응답) |
list_schemas |
데이터 모델 이름 목록/필터 |
get_schema |
단일 데이터 모델의 필드 트리 |
get_integration_guide |
호출 시퀀스를 포함한 유스케이스 가이드 |
generate_code_sample |
엔드포인트별 curl/TS/Python 코드 샘플 |
