Bulliza베타
MCP SERVER

제공되는 Tool

불리자 MCP 서버가 제공하는 tool 9개의 입력·출력 명세와 자연어 호출 예시예요. 앞의 4개는 불리자가 계산을 끝낸 결과(점수·랭킹·수출), 뒤의 4개는 당신의 AI가 자기 원칙을 만들 때 쓰는 원재료(재무 스냅샷·밸류 밴드·업종 퍼센타일·가격 시계열)예요. Claude 가 자동으로 적절한 tool 을 선택해 호출하지만, 이 페이지로 어떤 게 가능한지 한 번에 파악할 수 있어요.

get_stock_score

종목 1개의 점수·괴리율·적정가

종목 코드 하나를 받아서 AI 재무진단 점수(0~100), 등급(A+~D), 산식 기반 적정가, 현재가 대비 괴리율(상승여력 %)을 반환해요. KOSPI 6자리 숫자 또는 미국 티커 입력.

입력
이름타입설명
codestring (required)KOSPI 6자리(005930) 또는 미국 티커(AAPL)
자연어 예시
  • "삼성전자 점수 알려줘"
  • "AAPL 상승여력 어느 정도야?"
  • "하이닉스랑 마이크론 점수 비교해줘"
대응 REST 엔드포인트 — /api/public/v2/stocks/{code}/score

get_rankings

괴리율(상승여력) TOP 랭킹

V3 산식(성장×√규모×수급)으로 계산한 점수가 높은 종목을 순위대로 반환해요. 산식 본문과 백테스트 결과도 포함.

입력
이름타입설명
marketstring (KR|US|KR,US, 기본 KR)대상 시장
bandsstring (기본 "mega,xlarge,large")시총 구간 콤마. mega/xlarge/large/mid/small
limitinteger (1~100, 기본 10)반환 종목 수
자연어 예시
  • "KOSPI 1조+ 상승여력 TOP 10 보여줘"
  • "미국 메가캡 점수 상위 5개"
  • "한국 중형주 중에 저평가된 종목"
대응 REST 엔드포인트 — /api/public/v2/rankings

get_trade_total

한국 전체 수출·수입·무역수지 시계열

관세청 OpenAPI Newtrade(산자부 매월 발표값) 기반 한국 공식 수출입 월별 시계열. 1990-01 부터 데이터 있음. 미지정 시 최근 60개월.

입력
이름타입설명
fromstring YYYY-MM (선택)시작월
tostring YYYY-MM (선택)종료월
자연어 예시
  • "올해 한국 수출 추세 보여줘"
  • "2024년 무역수지 흑자 적자 월별로"
  • "코로나 이후 수출 회복 어땠어?"
대응 REST 엔드포인트 — /api/public/v2/exports/total

get_sector_exports

섹터별 수출 월별 + YoY 증감률

한국 수출을 섹터(반도체·자동차·조선·이차전지 등)별로 집계한 월별 시계열에 전년동월대비(YoY) 증감률을 같이 계산. 24개월 누적 기준 상위 N 섹터.

입력
이름타입설명
fromstring YYYY-MM (선택)시작월
tostring YYYY-MM (선택)종료월
topinteger (1~50, 기본 10)상위 N 섹터
자연어 예시
  • "반도체 수출 살아났어?"
  • "올해 가장 잘 나가는 한국 수출 섹터는?"
  • "이차전지 수출 작년대비 어때?"
대응 REST 엔드포인트 — /api/public/v2/exports/sectors

get_stock_snapshot

종목 1개의 재무 스냅샷 (TTM)

밸류에이션(PER·PBR·EV/EBIT)·수익성(ROE·ROIC·영업이익률)·성장성(매출·EPS YoY)·안정성(순부채비율·이자보상배율·유동비율)·현금창출(영업CF·FCF수익률)·이익의 질(CF/NI·CCC)을 한 번에. 모든 값에 단위·기준 분기·공시일·가격 기준일이 붙어요. "좋다/나쁘다"는 말하지 않아요 — 해석은 당신의 AI 몫.

입력
이름타입설명
codestring (required)KOSPI 6자리(005930) 또는 미국 티커(AAPL)
자연어 예시
  • "삼성전자 재무 요약해줘"
  • "ROE 15% 이상, 순부채 없는지 확인해줘"
  • "AAPL 현금흐름이 순이익보다 큰지 봐줘"
대응 REST 엔드포인트 — 아직 없어요 (MCP 전용)

get_valuation_band

과거 자기 자신 대비 밸류에이션 위치

PER·PBR·PSR이 2020년 이후 어떤 범위(하위 5%·중앙값·상위 5%·최소·최대)에서 움직였는지, 연도별 요약, 지금 어디에 있는지. 컨센서스가 아니라 실제 공시 이익(TTM)과 일별 종가로 계산한 그 종목의 역사예요.

입력
이름타입설명
codestring (required)KOSPI 6자리 또는 미국 티커
typestring (per|pbr|psr, 기본 per)지표 종류
fromstring YYYY-MM-DD (기본 2020-01-01)시작일
자연어 예시
  • "삼성전자 PER 역사적으로 어디쯤이야?"
  • "하이닉스 PBR이 과거 중앙값보다 낮아?"
  • "NVDA PER 연도별로 어떻게 변했어?"
대응 REST 엔드포인트 — 아직 없어요 (MCP 전용)

get_sector_percentile

같은 업종 안에서 몇 번째인지

17개 재무 지표 각각이 같은 업종(또는 같은 시장) 종목들 사이에서 몇 번째인지 퍼센타일(0~100)로. 코호트 크기와 원값을 같이 줘요. "ROE 12%가 좋은 건가?"는 절대값으로는 답이 없고, 업종 안 위치로만 답이 나와요.

입력
이름타입설명
codestring (required)KOSPI 6자리 또는 미국 티커
cohortstring (sector|market, 기본 sector)비교 집단
자연어 예시
  • "삼성전자 수익성이 반도체 업종에서 상위 몇 %야?"
  • "이 종목 부채 수준이 업종 평균보다 나빠?"
  • "NVDA를 나스닥 전체와 비교하면?"
대응 REST 엔드포인트 — 아직 없어요 (MCP 전용)

get_price_history

가격 시계열 (일·주·월봉)

시가·고가·저가·종가·거래량. 기본 최근 260 거래일, 최대 2,600봉. 이동평균·신고가·눌림목 같은 가격 규칙을 AI가 직접 계산하거나 "그때 샀으면"을 확인할 때 써요. KR 원, US 달러.

입력
이름타입설명
codestring (required)KOSPI 6자리 또는 미국 티커
intervalstring (day|week|month, 기본 day)봉 단위
fromstring YYYY-MM-DD (선택)시작일
tostring YYYY-MM-DD (선택)종료일
limitinteger (1~2600, 기본 260)봉 개수 상한
자연어 예시
  • "삼성전자 주봉 1년치 가져와서 20주 이동평균 위에 있는지 봐줘"
  • "AAPL 2024년 이후 월봉"
  • "최근 60일 중 고점 대비 얼마나 빠졌어?"
대응 REST 엔드포인트 — 아직 없어요 (MCP 전용)

health

키 상태 + 사용량 확인

내 API 키가 유효한지, 현재 어떤 플랜(free/paid)인지, 오늘 몇 회 호출했는지 확인.

입력

입력 인자 없음.

자연어 예시
  • "내 불리자 키 잘 동작해?"
  • "오늘 몇 번 썼어?"
대응 REST 엔드포인트 — /api/public/v2/health

직접 호출하기 (디버깅)

MCP 도 결국 JSON-RPC 2.0 over HTTP 라 curl 로 직접 호출할 수 있어요. tool 목록 확인:

bash
curl -X POST https://bulliza.com/api/mcp \
  -H "Authorization: Bearer rfk_live_<your-key>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

삼성전자 점수 조회:

bash
curl -X POST https://bulliza.com/api/mcp \
  -H "Authorization: Bearer rfk_live_<your-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc":"2.0","id":2,
    "method":"tools/call",
    "params":{"name":"get_stock_score","arguments":{"code":"005930"}}
  }'