토스증권 Open API MCP 서버

tossinvest-openapi-mcp — 토스증권 Open API(Toss Securities Open API)를 Claude·Cursor·Codex 같은 AI 에이전트가 쉽게 탐색·연동하도록 돕는 MCP 서버.

언어: 한국어 · English · 日本語

GitHub 저장소 사용 가이드(README)

이 프로젝트는 토스증권 OpenAPI 명세를 내장하여 MCP(Model Context Protocol) 도구로 제공합니다. 읽기 전용 문서/탐색 서버로, 실제 API를 호출하거나 주문을 실행하지 않으며 어떤 인증 정보도 필요로 하지 않습니다. AI 코딩 에이전트에 *"토스증권 API로 주문을 어떻게 넣어?"* 같이 물어보면 명세에 근거한 정확한 답변과 코드 샘플을 얻을 수 있습니다.

⚠️ 토스증권 공개 OpenAPI 문서를 설명하는 비공식 도구입니다. 실제 매매 실행·계좌 접근·인증 정보 전송을 하지 않습니다. 운영 적용 전 공식 토스증권 문서로 검증하세요.

주요 기능

• 토스증권 Open API의 모든 엔드포인트·카테고리 탐색
• 요청/응답 스키마와 예시 조회, 키워드 검색
• 유스케이스 중심 연동 가이드(인증·시세·계좌·주문)
• curl / TypeScript / Python 요청 코드 샘플 생성

설치 (stdio) — Claude / Cursor

Node.js 18+ 만 있으면 됩니다. MCP 클라이언트 설정에 아래를 추가하세요.

{
  "mcpServers": {
    "tossinvest-openapi": {
      "command": "npx",
      "args": ["-y", "tossinvest-openapi-mcp"]
    }
  }
}

설치 (stdio) — Codex CLI

[mcp_servers.tossinvest-openapi]
command = "npx"
args = ["-y", "tossinvest-openapi-mcp"]

제공 도구

도구	용도
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 코드 샘플 생성