Skip to main content
Glama
ryum91

tossinvest-mcp

by ryum91

tossinvest-mcp

토스증권 Open API를 Model Context Protocol(MCP)로 래핑한 서버입니다. Claude 등 MCP 호환 AI 클라이언트에서 국내/미국 주식 시세 조회 및 주문을 자연어로 실행할 수 있습니다.

제공 도구

카테고리

도구

설명

인증

issue_token

환경변수로 액세스 토큰 재발급

시세

get_prices

현재가 조회 (최대 200종목)

get_orderbook

호가 잔량 조회

get_trades

당일 체결 내역 조회

get_candles

캔들(OHLCV) 차트 데이터 (1분봉/일봉)

get_price_limits

상한가/하한가 조회

기술 지표

get_ema

지수이동평균(EMA) — 봉 단위·기간·기준가 지정

get_rsi

상대강도지수(RSI) — 과매수/과매도 구간·시그널 라인·크로스오버 신호 포함

get_macd

MACD — MACD 라인·시그널·히스토그램·크로스오버 신호

get_bollinger_bands

볼린저 밴드 — 상단·중간·하단 밴드·%B·밴드폭

get_ichimoku

일목균형표 — 전환선·기준선·선행스팬1·2·후행스팬·구름 방향·미래 구름 예측

get_atr

ATR(평균 실제 범위) — 변동성 측정, 포지션 사이징·스탑로스 거리 설정용

get_adx

ADX(평균 방향성 지수) — 추세 강도(≥25 강함)·방향(+DI/-DI)·추세/횡보 판별

get_stochastic

Slow Stochastic — %K·%D·과매수(≥80)/과매도(≤20)·크로스오버 신호

get_obv

OBV(누적 거래량) — 시그널 라인과 비교한 거래량 기반 추세 방향

get_volume_ma

거래량 이동평균 — 현재/평균 비율로 거래량 급등 감지

get_parabolic_sar

Parabolic SAR — 추세 방향·반전 신호·트레일링 스탑 기준선

AI 매매 지원

get_technical_summary

주요 지표 복합 조회 — RSI·MACD·BB·ADX·ATR·Stochastic·EMA·거래량·종합 신호 한 번에 반환

get_position_risk

포지션 리스크 계산 — ATR 기반 스탑로스 가격·적정 수량·최대 포지션 금액

log_trade

매매 이력 기록 — 근거(rationale)·지표 스냅샷·태그를 로컬 파일에 저장

get_trade_log

매매 이력 조회 — 종목·방향·날짜 필터, 최신순 반환

종목 정보

get_stocks

종목 기본 정보 (최대 200종목)

get_stock_warnings

투자 유의사항 조회

시장 정보

get_exchange_rate

KRW↔USD 환율 조회

get_kr_market_calendar

국내 시장 운영 시간

get_us_market_calendar

미국 시장 운영 시간

계좌

get_accounts

계좌 목록 조회

get_holdings

보유 주식 현황

get_buying_power

매수 가능 금액 조회

get_sellable_quantity

매도 가능 수량 조회

get_commissions

수수료율 조회

주문

create_order

매수/매도 주문 생성

modify_order

주문 정정

cancel_order

주문 취소

get_orders

주문 목록 조회

get_order

주문 상세 조회

Related MCP server: kookmin-stock

시작하기

1. 빌드

pnpm install
pnpm build

2. 환경변수 설정

토스증권 Open API에서 발급받은 Client ID와 Secret을 환경변수로 설정합니다. 두 값 모두 필수이며, 설정되지 않으면 서버가 시작되지 않습니다.

export TOSSINVEST_API_KEY=your_client_id
export TOSSINVEST_SECRET_KEY=your_client_secret

# 선택: AI 매매 이력 저장 경로 (기본값: ~/.tossinvest-mcp/trade-log.json)
export TOSSINVEST_TRADE_LOG_PATH=/path/to/trade-log.json

3. MCP 클라이언트 등록

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tossinvest": {
      "command": "node",
      "args": ["/path/to/tossinvest-mcp/dist/index.js"],
      "env": {
        "TOSSINVEST_API_KEY": "your_client_id",
        "TOSSINVEST_SECRET_KEY": "your_client_secret"
      }
    }
  }
}

Claude Code:

claude mcp add tossinvest -- node /path/to/tossinvest-mcp/dist/index.js

환경변수는 셸 프로파일(~/.zshrc 등)에 미리 설정해두거나 위 config의 env 블록으로 전달할 수 있습니다.

사용 예시

서버 시작 시 환경변수로 토큰이 자동 발급됩니다. 토큰 만료 시 issue_token 도구를 호출해 재발급할 수 있습니다.

삼성전자 현재가 알려줘
→ 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)

개발

pnpm dev   # TypeScript watch 모드
pnpm build # 빌드
pnpm start # 빌드된 서버 실행

라이선스

MIT

A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ryum91/tossinvest-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server