윤슬 사주 API·MCP 서버

AI 에이전트와 LLM 앱이 부르는 만세력 계산 도구입니다. 사주 명식·일진·운세 흐름·이달의 세운·궁합을 MCP 서버나 REST API 로 제공하고, 모델을 부르지 않는 결정론적 계산이라 같은 입력이면 같은 답을 줍니다.

어떤 도구가 있나요?

도구하는 일호출당
day_pillar
일진		특정 날짜의 일진(일주 두 글자)과 절입 기준 월주·연주.$0.02
saju_chart
사주 명식		생년월일시·출생지로 네 기둥 여덟 글자와 십신·12운성·지장간·공망·신살·팔자관계·대운을 세운다.$0.05
unse
운세 흐름		시작일부터 1~12개월 동안 일운·월운이 원국 네 기둥과 맺는 합·충·형·해·파.$0.1
monthly
이달의 세운		양력 한 달(YYYY-MM)의 절입 기준 월주·십신·일지 관계·좋은 날·주의 날·대운 충·오행 균형.$0.1
compatibility
궁합		두 명식의 일간·일지 합충과 오행 보완으로 본 궁합 지수.$0.1

도구 목록과 가격은 https://yunseul.threebillions.com/api/agent/v1/tools(무료, JSON), 입력 형식은 OpenAPI에 있습니다.

MCP 로 연결하려면?

MCP 서버 주소는 https://yunseul.threebillions.com/api/agent/mcp 입니다(Streamable HTTP). 도구 목록과 list_prices 는 키 없이 보이고, 계산 도구는 연결 헤더에 Authorization: Bearer <API 키> 를 넣습니다. 공식 MCP 레지스트리에는 com.threebillions.yunseul/saju 로 올라 있습니다. Claude Code 에서는 한 줄입니다.

claude mcp add --transport http yunseul https://yunseul.threebillions.com/api/agent/mcp --header "Authorization: Bearer ys_live_..."

Codex 에서는 키를 환경 변수 YUNSEUL_API_KEY 에 두고 연결합니다.

codex mcp add yunseul --url https://yunseul.threebillions.com/api/agent/mcp --bearer-token-env-var YUNSEUL_API_KEY

다른 MCP 클라이언트도 Streamable HTTP 와 Authorization 헤더를 지원하면 같은 주소로 연결합니다.

REST 로 부르려면?

curl -X POST https://yunseul.threebillions.com/api/agent/v1/tools/saju_chart \
  -H "Authorization: Bearer ys_live_..." -H "Content-Type: application/json" \
  -d '{"birth": {"year": 1986, "month": 10, "day": 8, "hour": 9, "minute": 16, "gender": "M", "city": "진주"}}'

birth 의 city 는 태어난 시·군·구 이름입니다. 태어난 시각을 모르면 hour·minute 를 빼고, 음력이면 is_lunar(윤달이면 is_leap_month)를 더합니다.

키와 결제는 어떻게 하나요?

두 가지이고, 결과와 가격은 같습니다.

구독이나 월 기본료 없이 부른 만큼만 냅니다. 입력이 틀리거나(422) 계산이 실패하면 과금하지 않습니다.

LLM 에 직접 물으면 안 되나요?

사주 여덟 글자는 분 단위의 절입 시각, 그 시절 표준시와 서머타임, 출생지 경도로 정해집니다. 언어 모델은 이 값을 기억에 기대 짐작하기 쉽고, 같은 질문에도 답이 달라질 수 있습니다. 계산은 도구에 맡기고 모델은 결과를 풀어 설명하는 데 쓰면, 설명이 근거로 삼는 네 기둥이 늘 같습니다.

무엇이 다른가요?

무료로 내 명식 보기