tossinvest-mcp
Wraps the Toss Securities Open API as an MCP server so AI clients can query KR/US stock data, compute indicators, inspect accounts, and place/manage real orders.
Market data: current prices, orderbooks, trades, candles, price limits, stock basics/warnings, FX rates, KR/US market calendars.
Technical analysis: EMA, RSI, MACD, Bollinger Bands, Ichimoku, ATR, ADX, Stochastic, OBV, volume MA, Parabolic SAR, and combined technical summaries.
Trading support: ATR-based stop-loss/position sizing, trade logging, and trade-log retrieval.
Account info: accounts, holdings, orders, buying power, sellable quantity, commissions.
Order management: create/modify/cancel LIMIT/MARKET orders with quantity or amount, TIF, client order ID, and high-value confirmation.
README extras: rankings, investor/program/short/credit/lending trends, market indicators, sectors, and conditional orders.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tossinvest-mcp 삼성전자 현재가 알려줘"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
tossinvest-mcp
토스증권 Open API를 Model Context Protocol(MCP)로 래핑한 서버입니다. Claude 등 MCP 호환 AI 클라이언트에서 국내/미국 주식 시세 조회 및 주문을 자연어로 실행할 수 있습니다.
토스증권 Open API v1.2.28 스펙 기준 (llms.txt · OpenAPI JSON). 웹소켓(실시간 체결·호가·주문 이벤트)은 MCP 요청/응답 모델과 맞지 않아 제공하지 않습니다.
빠른 시작
토스증권 Open API 키를 발급하고 허용 IP 를 등록한 뒤, 사용하는 클라이언트에 등록합니다. (Node.js 20.19 이상)
claude mcp add tossinvest --scope user \
-e TOSSINVEST_CLIENT_ID=tsck_live_xxx \
-e TOSSINVEST_CLIENT_SECRET=tssk_live_xxx \
-- npx -y @ryum91/tossinvest-mcpClaude Desktop · Cursor · VS Code · Codex 설정과 소스 빌드, 문제 해결은 설치 가이드를 참고하세요.
Related MCP server: tossinvest-openapi-mcp
제공 도구
카테고리 | 도구 | 설명 |
인증 |
| 액세스 토큰 강제 재발급 (평소에는 자동 갱신되므로 불필요) |
시세 |
| 현재가 조회 (최대 200종목) |
| 호가 잔량 조회 | |
| 당일 체결 내역 조회 | |
| 캔들(OHLCV) 차트 데이터 (1분봉/일봉) | |
| 상한가/하한가 조회 | |
기술 지표 |
| 지수이동평균(EMA) — 봉 단위·기간·기준가 지정 |
| 상대강도지수(RSI) — 과매수/과매도 구간·시그널 라인·크로스오버 신호 포함 | |
| MACD — MACD 라인·시그널·히스토그램·크로스오버 신호 | |
| 볼린저 밴드 — 상단·중간·하단 밴드·%B·밴드폭 | |
| 일목균형표 — 전환선·기준선·선행스팬1·2·후행스팬·구름 방향·미래 구름 예측 | |
| ATR(평균 실제 범위) — 변동성 측정, 포지션 사이징·스탑로스 거리 설정용 | |
| ADX(평균 방향성 지수) — 추세 강도(≥25 강함)·방향(+DI/-DI)·추세/횡보 판별 | |
| Slow Stochastic — %K·%D·과매수(≥80)/과매도(≤20)·크로스오버 신호 | |
| OBV(누적 거래량) — 시그널 라인과 비교한 거래량 기반 추세 방향 | |
| 거래량 이동평균 — 현재/평균 비율로 거래량 급등 감지 | |
| Parabolic SAR — 추세 방향·반전 신호·트레일링 스탑 기준선 | |
AI 매매 지원 |
| 주요 지표 복합 조회 — RSI·MACD·BB·ADX·ATR·Stochastic·EMA·거래량·종합 신호 한 번에 반환 |
| 포지션 리스크 계산 — ATR 기반 스탑로스 가격·적정 수량·최대 포지션 금액 | |
| 매매 이력 기록 — 근거(rationale)·지표 스냅샷·태그를 로컬 파일에 저장 | |
| 매매 이력 조회 — 종목·방향·날짜 필터, 최신순 반환 | |
종목 정보 |
| 종목 기본 정보 (최대 200종목) |
| 마켓별 전체 종목 목록 (종목명 검색·개수 제한 지원) | |
| 투자 유의사항 조회 | |
수급 동향 (국내) |
| 투자자별 매매동향 (개인·외국인·기관·기타법인, 외국인 보유, CFD) |
| 프로그램매매 동향 (차익·비차익) | |
| 공매도 동향 | |
| 신용거래 동향 (융자·대주) | |
| 대차거래 동향 | |
랭킹 |
| 거래대금·거래량·급등락·토스증권 체결 상위 (KR/US, 실시간~1년) |
| 외국인·기관·개인 순매수/순매도 상위 (국내) | |
시장 지표 |
| 코스피·코스닥·국채(2~30년) 현재가 |
| 지수·국채 캔들 | |
| 코스피·코스닥 투자자별 매매대금 | |
섹터 |
| 섹터 분류 전체 (계층 구조) |
| 섹터 상세 (기간 등락률) | |
| 섹터 구성 주식 | |
| 섹터 관련 ETF | |
| 섹터 랭킹 (등락률·거래대금) | |
시장 정보 |
| KRW↔USD 환율 조회 |
| 국내 시장 운영 시간 | |
| 미국 시장 운영 시간 | |
계좌 |
| 계좌 목록 조회 |
| 보유 주식 현황 | |
| 거래내역 (매매·입출금·환전·배당·이자·수수료) | |
| 매수 가능 금액 조회 | |
| 매도 가능 수량 조회 | |
| 수수료율 조회 | |
주문 |
| 매수/매도 주문 생성 |
| 주문 정정 | |
| 주문 취소 | |
| 주문 목록 조회 | |
| 주문 상세 조회 | |
조건주문 |
| 조건주문 등록 (SINGLE · OCO · OTO) |
| 조건주문 수정 (새 ID 발급) | |
| 조건주문 취소 | |
| 조건주문 목록 (OPEN / CLOSED) | |
| 조건주문 상세 |
설치 가이드
사전 준비
Node.js 20.19 이상 (
node -v로 확인)토스증권 Open API 키 발급: 토스증권 WTS 로그인 → 설정 → Open API →
client_id/client_secret발급허용 IP 등록: 같은 화면의 허용 IP 관리에 이 서버를 실행할 PC의 공인 IP를 등록합니다. 등록하지 않으면 토큰 발급과 모든 API 호출이 403 으로 거부됩니다. (공인 IP 확인:
curl ifconfig.me)
⚠️ 이 서버는 실제 계좌에 주문을 낼 수 있는 도구(주문·조건주문 생성/정정/취소)를 포함합니다. MCP 클라이언트가 해당 도구 호출 전에 사용자 승인을 받도록 설정하고, 자동 승인("항상 허용")은 권장하지 않습니다.
방법 1. npx 로 설치 (권장)
빌드 없이 npm 패키지 @ryum91/tossinvest-mcp를 바로 실행합니다. 키는 MCP 클라이언트 설정의 env 로 전달합니다.
Claude Code
claude mcp add tossinvest --scope user \
-e TOSSINVEST_CLIENT_ID=tsck_live_xxx \
-e TOSSINVEST_CLIENT_SECRET=tssk_live_xxx \
-- npx -y @ryum91/tossinvest-mcp--scope user 는 모든 프로젝트에서 사용, 생략하면 현재 프로젝트에서만 사용합니다. 확인: claude mcp get tossinvest
Claude Desktop
설정 → 개발자 → 구성 편집, 또는 파일을 직접 수정합니다.
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"tossinvest": {
"command": "npx",
"args": ["-y", "@ryum91/tossinvest-mcp"],
"env": {
"TOSSINVEST_CLIENT_ID": "tsck_live_xxx",
"TOSSINVEST_CLIENT_SECRET": "tssk_live_xxx"
}
}
}
}저장 후 Claude Desktop 을 완전히 종료했다가 다시 실행합니다.
Cursor
~/.cursor/mcp.json (전역) 또는 프로젝트의 .cursor/mcp.json — 위 Claude Desktop 과 같은 mcpServers 형식입니다.
VS Code (GitHub Copilot)
프로젝트의 .vscode/mcp.json 또는 명령 팔레트의 MCP: Open User Configuration:
{
"servers": {
"tossinvest": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@ryum91/tossinvest-mcp"],
"env": {
"TOSSINVEST_CLIENT_ID": "tsck_live_xxx",
"TOSSINVEST_CLIENT_SECRET": "tssk_live_xxx"
}
}
}
}Codex
~/.codex/config.toml:
[mcp_servers.tossinvest]
command = "npx"
args = ["-y", "@ryum91/tossinvest-mcp"]
env = { TOSSINVEST_CLIENT_ID = "tsck_live_xxx", TOSSINVEST_CLIENT_SECRET = "tssk_live_xxx" }설정 파일에 실제 키가 들어가므로 저장소에 커밋하지 마세요 (
.mcp.json,.cursor/mcp.json,.vscode/mcp.json등 프로젝트 단위 설정 파일 주의).
방법 2. 소스에서 빌드
git clone https://github.com/ryum91/tossinvest-mcp.git
cd tossinvest-mcp
pnpm install
pnpm build키는 레포 루트의 .env.local 에 넣습니다 (.gitignore 처리됨). 서버가 시작할 때 .env.local → .env 순서로 자동으로 읽으며, MCP 설정의 env 나 셸 환경변수가 있으면 그 값이 우선합니다.
# .env.local
TOSSINVEST_CLIENT_ID=tsck_live_xxx
TOSSINVEST_CLIENT_SECRET=tssk_live_xxx클라이언트에는 npx 대신 빌드 결과를 등록합니다 (.env.local 을 쓰면 env 는 생략 가능).
claude mcp add tossinvest -- node /절대/경로/tossinvest-mcp/dist/index.js{
"mcpServers": {
"tossinvest": {
"command": "node",
"args": ["/절대/경로/tossinvest-mcp/dist/index.js"]
}
}
}환경변수
변수 | 필수 | 설명 |
| ✅ | Open API client_id |
| ✅ | Open API client_secret |
| AI 매매 이력 저장 경로 (기본 | |
| 토큰 캐시 경로 (기본 |
구 변수명
TOSSINVEST_API_KEY/TOSSINVEST_SECRET_KEY도 하위 호환으로 인식합니다.
설치 확인
클라이언트를 다시 시작한 뒤 AI 에게 다음과 같이 요청합니다.
삼성전자 현재가 알려줘
→ get_prices(symbols: "005930")정상이라면 도구 58개가 등록되고 현재가가 반환됩니다. 서버 로그(stderr)에는 토큰 확보 성공. MCP 서버가 준비되었습니다. 가 출력됩니다.
업데이트
npx: 이미 받아 둔 버전이 캐시에 있으면 그대로 쓰일 수 있습니다. 최신 버전을 쓰려면 설정의 패키지를
@ryum91/tossinvest-mcp@latest로 지정하거나, 캐시(rm -rf ~/.npm/_npx)를 지우고 클라이언트를 재시작하세요.소스:
git pull && pnpm install && pnpm build
문제 해결
증상 | 원인 / 해결 |
| 현재 PC 의 공인 IP 가 허용 IP 에 없습니다. WTS → 설정 → Open API → 허용 IP 관리에 등록하세요. (VPN·회사망·모바일 핫스팟은 IP 가 바뀝니다) |
|
|
| 같은 키로 다른 곳에서 토큰을 새로 발급했습니다 (토큰은 클라이언트당 1개). 서버가 자동으로 재발급하지만, 같은 키를 여러 프로그램에서 동시에 쓰면 서로 토큰을 무효화할 수 있습니다. |
429 / | 초당 호출 한도 초과. 서버가 |
서버가 시작되지 않음 ( |
|
| 처음 한 번은 패키지를 내려받느라 시간이 걸립니다. 계속 실패하면 터미널에서 |
도구가 보이지 않음 | 클라이언트를 완전히 종료 후 재시작하세요. Claude Code 는 |
토큰 관리
액세스 토큰은 첫 호출 시 발급되어
~/.tossinvest-mcp/token.json(권한 600)에 캐시되고, 만료 5분 전 또는 401(expired-token·invalid-token·token-revoked) 응답 시 자동 갱신됩니다.토스증권은 클라이언트당 토큰 1개만 유효하므로, 여러 MCP 프로세스(여러 세션)가 캐시를 공유해 서로의 토큰을 무효화하지 않도록 했습니다.
429(Rate Limit) 응답은
Retry-After만큼 대기 후 최대 3회 재시도합니다.
도구 메타데이터 · 입력 검증
툴 성격(annotations)·제목(title): 모든 도구에 한글 제목과 성격 힌트를 붙여 MCP 클라이언트가 승인 정책을 구분할 수 있습니다.
구분
도구
readOnly
destructive
idempotent
openWorld
조회
시세·지표·계좌·주문 조회 등 49개
✅
—
✅
✅
주문
create_order,modify_order,create_conditional_order,modify_conditional_order—
✅
—
✅
주문 취소
cancel_order,cancel_conditional_order—
✅
✅
✅
로컬
log_trade(기록) /get_trade_log(조회)—/✅
—
—/✅
—
인증
issue_token—
—
—
✅
서버 지침(instructions): 계좌 API 전
get_accounts선행, 주문 도구는 사용자 승인 후에만 호출,confirm_high_value_order사용 조건 등을 MCP 클라이언트에 전달합니다.입력 검증 (zod): 각 도구의 입력은 zod 스키마 하나로 정의되며, 같은 스키마에서 tools/list 의 JSON Schema 생성과 tools/call 인자 검증·타입 보정을 모두 처리합니다. API 호출 전에 위반 항목을 한 번에 모두 알려줍니다 (한국어 메시지, 입력값 표시).
형식·범위: 심볼 패턴, 0보다 큰 decimal 문자열, 날짜(실존 여부 포함)·ISO 일시, 정수/범위(
count·limit·기간 파라미터), enum조합 규칙: 수량/금액 중 하나만, 지정가↔가격 필수/금지, 금액 주문은 MARKET 전용·
time_in_force불가, 소수점 수량은 MARKET SELL 전용(6자리), CLS 는 LIMIT 전용, 조건주문 SINGLE/OCO/OTO 별second·방향·감시가 순서·LIMIT 전용 규칙, 만료일(오늘~1년), 조회 기간 from ≤ to, 랭킹realtime제약, 국채 분봉 불가 등관대한 타입 보정:
"5"→5, 5→"5","true"→true,"BUY,SELL"→["BUY","SELL"], 선택 필드의null/빈 문자열은 미지정 처리
사용 예시
삼성전자 현재가 알려줘
→ get_prices(symbols: "005930")
AAPL 일봉 차트 100개 가져와
→ get_candles(symbol: "AAPL", interval: "1d", count: 100)
내 계좌 보유 종목 보여줘
→ get_accounts() → get_holdings(account_seq: ...)
삼성전자 1주 시장가 매수
→ create_order(symbol: "005930", side: "BUY", order_type: "MARKET", quantity: "1", ...)
AAPL 일봉 20일 EMA 계산해줘
→ get_ema(symbol: "AAPL", interval: "1d", period: 20)
삼성전자 RSI 알려줘
→ get_rsi(symbol: "005930", interval: "1d")
(기본값: period=14, overbought=70, oversold=30, signal_period=14)
AAPL MACD 계산해줘
→ get_macd(symbol: "AAPL", interval: "1d")
(기본값: fast_period=12, slow_period=26, signal_period=9)
삼성전자 볼린저 밴드 보여줘
→ get_bollinger_bands(symbol: "005930", interval: "1d")
(기본값: period=20, multiplier=2)
AAPL 일목균형표 분석해줘
→ get_ichimoku(symbol: "AAPL", interval: "1d")
(기본값: tenkan=9, kijun=26, senkou_b=52, displacement=26)
오늘 코스피 거래대금 상위 10개
→ get_rankings(type: "MARKET_TRADING_AMOUNT", market_country: "KR", duration: "1d", count: 10)
삼성전자 외국인 수급 최근 5일
→ get_stock_investor_trading(symbol: "005930", count: 5)
AAPL 10주 보유분 360달러 익절 / 320달러 손절 걸어줘 (OCO)
→ create_conditional_order(account_seq: 1, symbol: "AAPL", type: "OCO", quantity: "10", order_type: "LIMIT",
expire_date: "2026-12-31",
first: { order_side: "SELL", trigger_price: "360", order_price: "360" },
second: { order_side: "SELL", trigger_price: "320", order_price: "319.5" })기술 지표의 5m/30m/60m 봉은 1분봉을, 1w/1mo 봉은 일봉을 집계해 계산합니다. 1분봉은 최대 8,000개(40페이지)까지 조회하므로 분봉 기반 장기 지표(예: 60m 일목균형표)는 데이터가 부족할 수 있습니다.
개발
프로젝트 구조
src/
├── index.ts # 진입점: 환경변수 확인 → 서버 시작 → 토큰 사전 확보
├── server.ts # MCP 서버 (서버 지침 instructions, tools/list · tools/call)
├── config.ts # .env.local/.env 로딩, 클라이언트 키, 로컬 파일 경로
├── api/
│ ├── auth.ts # 토큰 발급 · 파일 캐시 공유 · 자동 갱신
│ └── client.ts # HTTP (result 언랩, 401 재발급, 429 재시도, 에러 envelope)
├── lib/
│ ├── args.ts # 인자 변환 헬퍼 (decimal 문자열, optional 값)
│ ├── candles.ts # 캔들 페이지 조회 · 5m/30m/60m/1w/1mo 집계
│ ├── indicators/ # 지표 계산 순수 함수 — 지표별 1파일 (+ index.ts)
│ │ └── ema · rsi · macd · bollinger-bands · ichimoku · atr · adx · stochastic · obv · parabolic-sar
│ ├── trade-log.ts # 매매 로그 파일 저장소
│ └── schema.ts # zod 공통 빌더(accountSeq·symbol·positiveDecimal·isoDate…) · JSON Schema 생성 · 인자 파싱
└── tools/
├── types.ts # ToolDefinition · 툴 성격(kind) → annotations
├── index.ts # 툴 레지스트리 (목록 순서, 이름 중복 검사, 검증 후 핸들러 실행)
├── indicators/ # 지표 도구 — 지표별 1파일 (+ index.ts 노출 순서)
│ └── ema · rsi · macd · bollinger-bands · ichimoku · atr · adx · stochastic · obv · volume-ma · parabolic-sar
├── market-data.ts ├── trading-support.ts
├── stock-info.ts ├── stock-trends.ts ├── market-info.ts
├── ranking.ts ├── market-indicators.ts├── sector.ts
├── account.ts ├── order.ts ├── order-info.ts
├── conditional-order.ts ├── trade-log.ts └── auth.ts도구 추가 방법
각 도구는 스키마·제목·성격·조합 검증·핸들러를 한 객체(ToolDefinition)에 함께 정의합니다. 해당 카테고리 파일의 배열에 추가하면 되고, 새 카테고리라면 tools/index.ts 의 toolDefinitions 에 등록합니다.
새 기술 지표는 계산 함수를 lib/indicators/<지표>.ts 에, 도구를 tools/indicators/<지표>.ts 에 만들고 각 폴더의 index.ts 에 추가합니다.
import { z } from "zod";
import { count, enumOf, symbol } from "../lib/schema.js";
import { defineTool } from "./types.js";
defineTool({
name: "get_something",
title: "무언가 조회", // 한글 제목
kind: "read", // read | trade | trade-cancel | local-read | local-write | auth
description: "...",
input: z.object({
symbol: symbol.describe("종목 심볼 (예: 005930, AAPL)"),
side: enumOf(["BUY", "SELL"]).describe("매수/매도"),
count: count(50).optional().describe("조회 건수 (최대 50)"),
}),
// (선택) 필드 조합 규칙 — "field: 내용" 형태로 넣으면 해당 경로의 zod 이슈가 됩니다
validate: (a, errors) => {
if (a.side === "SELL" && !a.count) errors.push("count: SELL 이면 필수입니다");
},
// args 타입은 input 스키마에서 추론됩니다 ({ symbol: string; side: "BUY" | "SELL"; count?: number })
handler: async (args) => apiRequest("GET", "/api/v1/something", { symbol: args.symbol, count: args.count }),
});공통 빌더(lib/schema.ts)는 토스증권 스펙의 형식·범위를 담고 있고, LLM 이 보내는 느슨한 입력을 보정합니다: "5"→5, 5→"5", "true"→true, "A,B"→["A","B"], 앞뒤 공백 제거, 선택 필드의 null/빈 문자열은 미지정 처리, 알 수 없는 키는 무시.
pnpm dev # TypeScript watch 모드
pnpm build # 빌드
pnpm start # 빌드된 서버 실행
pnpm lint # ESLint (typescript-eslint, 타입 기반 규칙)
pnpm lint:fix # ESLint 자동 수정
pnpm format # Prettier 포매팅
pnpm format:check # Prettier 포맷 검사
pnpm typecheck # tsc --noEmit
pnpm check # typecheck + lint + format:check (커밋 전 확인용)코드 스타일
Prettier (
.prettierrc.json): 120자, 큰따옴표, 세미콜론, trailing comma.openapi.json(외부 스펙 원본)은 제외ESLint (
eslint.config.js, flat config):@eslint/jsrecommended +typescript-eslintrecommendedTypeChecked +eslint-config-prettier추가 규칙:
no-floating-promises(주문 API 호출 await 누락 방지),consistent-type-imports,eqeqeq, 미사용 변수(_접두사 허용)
es-toolkit: 반올림(
round)·합/평균(sum·mean·sumBy·meanBy)·그룹핑(groupBy)·배열(last·takeRight·uniq)·객체(omitBy·mapValues·isPlainObject)·비동기(delay·Mutex) 등 유틸리티는 직접 구현하지 않고 es-toolkit 을 사용합니다
라이선스
MIT
Available Tools
36 toolscancel_orderA
기존 주문을 취소합니다. 이미 체결된 주문은 취소할 수 없습니다.
Inputs: order_id (required), account_seq (required).
create_orderA
매수 또는 매도 주문을 생성합니다. quantity(수량) 또는 order_amount(금액) 중 하나를 지정합니다. order_amount는 미국 주식 시장가 주문 전용입니다.
Inputs: side (required), symbol (required), order_type (required), account_seq (required), +6 more.
get_accountsA
사용자의 계좌 목록을 조회합니다. 응답의 accountSeq를 다른 계좌 관련 API의 account_seq 파라미터에 사용합니다.
Inputs: no named parameters.
get_adxA
종목의 ADX(평균 방향성 지수)를 계산합니다. ADX≥25이면 강한 추세, +DI>-DI이면 상승 추세. 추세/횡보 판별로 전략 전환에 활용됩니다.
Inputs: symbol (required), interval (required), period.
get_atrA
종목의 ATR(평균 실제 범위)을 계산합니다. Wilder 평활법 사용. 변동성 측정으로 포지션 사이징과 스탑로스 거리 자동 설정에 활용됩니다.
Inputs: symbol (required), interval (required), period.
get_bollinger_bandsB
종목의 볼린저 밴드를 계산합니다. 중간선(SMA), 상단·하단 밴드, %B(현재가 위치), 밴드폭을 반환합니다.
Inputs: symbol (required), interval (required), period, multiplier, +1 more.
get_buying_powerA
매수 주문 시 사용 가능한 현금 기반 매수 가능 금액을 조회합니다 (미수 미발생 기준).
Inputs: currency (required), account_seq (required).
get_candlesA
종목의 캔들(OHLCV) 차트 데이터를 조회합니다. 1분봉(1m) 또는 일봉(1d)을 지원하며 최대 200개를 반환합니다.
Inputs: symbol (required), interval (required), count, before, +1 more.
get_commissionsA
현재 계좌의 시장별(국내/미국) 매매 수수료율을 조회합니다.
Inputs: account_seq (required).
get_emaA
종목의 지수이동평균(EMA)을 계산합니다. 캔들 데이터를 기반으로 지정한 봉 단위·기간·계산 기준으로 EMA 시계열을 반환합니다.
Inputs: period (required), symbol (required), interval (required), price_field.
get_exchange_rateB
KRW↔USD 환율 정보를 조회합니다. 1분 주기로 갱신되는 참고용 표시 환율입니다.
Inputs: base_currency (required), quote_currency (required), date_time.
get_holdingsB
계좌의 보유 주식 현황(수량, 매입가, 평가금액, 손익)을 조회합니다. 국내/미국 주식 모두 포함됩니다.
Inputs: account_seq (required), symbol.
get_ichimokuA
종목의 일목균형표를 계산합니다. 전환선·기준선·선행스팬1·2·후행스팬과 구름(kumo) 방향, 향후 displacement 기간의 구름 예측을 반환합니다.
Inputs: symbol (required), interval (required), displacement, kijun_period, +2 more.
get_kr_market_calendarA
국내 시장(KRX+NXT 통합 모드)의 장 운영 시간을 조회합니다. 전일/당일/익일 3영업일 정보를 반환합니다.
Inputs: date.
get_macdB
종목의 MACD(이동평균 수렴확산)를 계산합니다. MACD 라인, 시그널 라인, 히스토그램, 크로스오버 신호를 반환합니다.
Inputs: symbol (required), interval (required), fast_period, slow_period, +1 more.
get_obvA
종목의 OBV(누적 거래량)를 계산합니다. 시그널 라인(EMA of OBV)과 비교해 거래량 기반 추세 방향을 반환합니다.
Inputs: symbol (required), interval (required), signal_period.
get_orderA
특정 주문의 상세 정보를 조회합니다. 모든 상태의 주문을 조회할 수 있습니다.
Inputs: order_id (required), account_seq (required).
get_orderbookA
종목의 매수/매도 호가 및 잔량을 조회합니다.
Inputs: symbol (required).
get_ordersA
주문 목록을 조회합니다. OPEN(진행 중) 또는 CLOSED(종료됨)으로 필터링합니다.
Inputs: status (required), account_seq (required), to, from, +3 more.
get_parabolic_sarA
종목의 Parabolic SAR를 계산합니다. 추세 방향·반전 신호·트레일링 스탑 기준선을 반환합니다.
Inputs: symbol (required), interval (required), step, max_af, +1 more.
get_position_riskA
ATR 기반 스탑로스 가격과 계좌 잔고 대비 적정 포지션 규모를 계산합니다. AI 자동매매에서 주문 전 리스크 관리용으로 호출합니다.
Inputs: symbol (required), account_seq (required), side, interval, +4 more.
get_price_limitsA
종목의 당일 상한가 및 하한가를 조회합니다. 미국 주식은 가격제한이 없어 null로 반환됩니다.
Inputs: symbol (required).
get_pricesA
종목의 현재가를 조회합니다. 최대 200개 종목을 콤마로 구분하여 한 번에 조회 가능합니다.
Inputs: symbols (required).
get_rsiA
종목의 RSI(상대강도지수)를 계산합니다. Wilder 평활법을 사용하며 과매수/과매도 구간, 시그널 라인(RSI의 EMA), 크로스오버 신호를 함께 반환합니다.
Inputs: symbol (required), interval (required), period, oversold, +2 more.
get_sellable_quantityC
특정 종목의 매도 가능 수량을 조회합니다.
Inputs: symbol (required), account_seq (required).
get_stochasticA
종목의 Slow Stochastic을 계산합니다. %K, %D, 과매수(≥80)/과매도(≤20) 구간, 크로스오버 신호를 반환합니다.
Inputs: symbol (required), interval (required), d_period, k_period, +1 more.
get_stocksA
종목의 기본 정보(종목명, 시장, 통화, 상장상태 등)를 조회합니다. 최대 200개를 콤마로 구분하여 한 번에 조회 가능합니다.
Inputs: symbols (required).
get_stock_warningsA
종목의 매수 유의사항(정리매매, 단기과열, 투자경고/위험, VI 발동, 신주인수권 등)을 조회합니다.
Inputs: symbol (required).
get_technical_summaryA
종목의 주요 기술 지표를 한 번에 조회합니다. 현재가·RSI·MACD·볼린저밴드·ADX·ATR·스토캐스틱·EMA20/60·거래량MA와 종합 신호(signal score)를 반환합니다. AI 자동매매에서 분석 호출 횟수를 최소화하는 데 적합합니다.
Inputs: symbol (required), interval.
get_trade_logA
로컬에 저장된 AI 매매 이력을 조회합니다. 과거 매매 근거·지표 상태를 파악해 현재 전략 판단에 활용합니다.
Inputs: side, limit, symbol, to_date, +1 more.
get_tradesA
종목의 당일 최근 체결 내역을 조회합니다.
Inputs: symbol (required), count.
get_us_market_calendarA
미국 시장의 장 운영 시간을 조회합니다. 데이마켓/프리마켓/정규장/애프터마켓 세션별로 반환하며 전일/당일/익일 3영업일 정보를 제공합니다.
Inputs: date.
get_volume_maB
종목의 거래량 이동평균을 계산합니다. 현재/평균 거래량 비율로 급등 거래량을 감지합니다.
Inputs: symbol (required), interval (required), period, spike_threshold.
issue_tokenA
환경변수 TOSSINVEST_API_KEY(client_id)와 TOSSINVEST_SECRET_KEY(client_secret)를 사용해 액세스 토큰을 재발급합니다. 별도 파라미터 없이 호출하면 됩니다.
Inputs: no named parameters.
log_tradeA
매매 실행 후 근거·지표 스냅샷을 로컬 파일에 기록합니다. create_order 호출 후 반드시 호출해 AI 매매 이력을 남깁니다.
Inputs: side (required), symbol (required), quantity (required), account_seq (required), +6 more.
modify_orderA
기존 주문의 가격 또는 수량을 정정합니다. 국내 주식은 가격+수량 정정 가능, 미국 주식은 가격만 정정 가능합니다.
Inputs: order_id (required), order_type (required), account_seq (required), price, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 36 tools
Most tools have clearly distinct purposes, and the verb_noun naming helps. However, get_technical_summary overlaps with several individual indicator tools (RSI, MACD, Bollinger, etc.), which could cause an agent to call redundant tools, so a slight deduction.
All tools use consistent snake_case, with get_ for data retrieval and verbs (create/modify/cancel/log) for actions. This pattern is uniform and predictable.
With 36 tools, this is well above the 25 threshold for 'too many.' While each tool may serve a useful function, the sheer volume makes the set heavy and harder for an agent to navigate.
The server covers the full investment workflow: account info, market data, technical analysis, order management, risk management, and trade logging. No obvious dead ends; an AI agent can make informed trades and track them.
Maintenance
Related MCP Connectors
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
MCP server for Financial Modeling Prep API with 250+ financial data tools
MCP server for stocksense-ai documentation, generated by doc2mcp.
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that enables natural language control of Kiwoom Securities accounts through Claude Desktop. It provides tools for stock price lookup, buying and selling stocks, and analyzing portfolios or trade history via the Kiwoom REST API.112MIT
- AlicenseCqualityCmaintenanceSafe-by-default MCP server for the official Toss Securities Open API, providing read-only market and account data with optional order operations protected by multiple safety gates.272MIT
- AlicenseAqualityDmaintenanceSelf-hosted MCP server that wraps the Toss Securities Open API, enabling natural language queries for account balances, holdings, transactions, and stock prices via Claude.4MIT
- AlicenseAqualityDmaintenanceA local MCP server that automatically generates tools from Toss Securities' official OpenAPI spec, enabling real API calls with multi-layered order safety and OAuth 2.0 authentication.361MIT