FarmTempo
Server Details
Korean produce wholesale reference prices, buy-or-wait signals and deal price checks with sources.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 43 tools
Most tools have long descriptions that explicitly differentiate them, but the set contains many near-siblings in the price-retrieval space: get_wholesale_prices, get_auction_price, tempo_reference_price, market_ticker, market_list_items, market_get_item, get_item_price_history, and compare_my_price_vs_wholesale all return price data with only subtle source/basis distinctions. The USDA family (usda_catalog, usda_movement_catalog, usda_sp_catalog, usda_latest, usda_sp_latest, usda_prices, usda_sp_prices) is similarly dense, and decide_buy_or_wait vs decide_buy_plan require careful reading to separate. Descriptions do rescue it, but misselection risk is real.
Two competing conventions coexist: verb-first (get_auction_price, calculate_margin, decide_buy_or_wait, check_deal_price) and noun-first (items_get, items_list, items_resolve, market_get_item, market_list_items, region_list, onboard_roles, lots_reconcile). Domain prefixes (mkt_, usda_, market_, items_, tempo_, onboard_) are applied inconsistently — some resources get a prefix, others don't, and the same resource family uses both orders (market_get_item vs get_auction_price vs get_auction_markets).
43 tools is well above the comfortable range, and the surface is fragmented across many partially overlapping families (9 USDA tools, ~8 price/quote tools, ~6 market/matching tools). Several entries look like thin catalog/variant wrappers around the same underlying data source, which inflates the count. The breadth of domain is real, but the set would benefit from consolidation.
Coverage is unusually thorough for a price-intelligence and sourcing-support domain: pricing across multiple bases, weather correlation, seasonal norms, event signals, market calendar, delivery coverage, listing/RFQ search, USDA redistribution, and onboarding stats. The main gaps are transactional writes (no listing creation, no RFQ bid submission, no order execution), which appear deliberately excluded by the human-approval design rather than accidentally missing.
Available Tools
43 toolscalculate_marginARead-onlyIdempotentInspect
단일 품목의 원가(직납가)와 판매가로부터 원가율·마진율·마진액·자연어 평가를 반환합니다. 마트 영업 미팅·발주서 작성·B2AI 자동 발주 권고에 활용.
파라미터
cost_price(query, required): 직납가 / 원가 (KRW)sell_price(query, required, >0): 판매가 (KRW)item_name(query, optional): 품목명 (한글, 응답에 echo)
assessment 임계값
≥30% → '양호'
15-30% → '보통'
<15% → '낮음 — 가격 재검토 권장'
Returns single-item margin/cost rate with natural-language assessment.
Inputs: cost_price (required), sell_price (required), item_name. Returns: object
calculate_margin_bulkBRead-onlyIdempotentInspect
여러 품목의 매입·판매 행을 일괄로 계산해 행별·총계 결과를 반환합니다. HTML 원가율 계산기 탭의 calcRow + totals 와 동일 출력.
Body 스키마
{"rows": [{"item": "배추", "buyPrice": 1000, "sellPrice": 1500, "qty": 1}]}Returns per-row + aggregated totals for bulk margin calculation.
Inputs: rows (required). Returns: object
check_deal_priceARead-onlyIdempotentInspect
거래 직전에 부르는 도구. 최근 10거래일 aT 도매 정산가 범위(±5%)와 템포 기준 시세 v1 대비 차이를 준다. role=buyer|seller 면 그쪽 관점의 한 줄. 참고 판정이며 가격 결정·확정은 당사자.
Inputs: item (required), price (required), role.
compare_my_price_vs_wholesaleARead-onlyIdempotentInspect
등록된 직납가와 현재 도매가를 비교하여 품목별 절감율을 계산. 마트 영업 미팅용 비교표 생성에 사용.
Compares direct-supply prices against current wholesale prices.
Inputs: no named parameters. Returns: object
decide_buy_or_waitARead-onlyIdempotentInspect
오늘 시세, 7일 뒤 범위(템포 레인지), 평년 대비, 세 예측 의견, 변동 주의, 과거 성적(어제 가격 대비), 대체 품목을 한 번에 묶어 '1주 기다리기 / 지금 사기 / 필요한 만큼만 / 모름' 참고 신호를 줍니다. 숫자마다 출처·기준일(receipts). 판단 규칙(rule)을 응답에 싣고, 그 규칙의 성과는 아직 검증 전입니다. 사용자에게 '확정은 사람'임을 밝히세요. qty(kg)를 주면 지금 살 때와 7일 뒤 예상 금액을 함께 줍니다.
Inputs: qty, item, item_key.
decide_buy_planARead-onlyIdempotentInspect
aT 도매 정산가 기준 26품목. 필요량(kg)과 기한(오늘~7일)을 주면 세 가지 사는 방법의 예상 금액(중앙값·80% 범위, 신선도 손실 가정 포함)과 묶음별 과거 성적(과거 자료 검증·가상 구매 계산: 평균 절감·나쁜 5% 날·손해 본 날 비율)을 줍니다. 팜템포는 고르거나 주문하지 않습니다. 금액은 예측 기반 예시이며 약속이 아님을 사용자에게 밝히세요.
Inputs: qty (required), item (required), days, weekly, +1 more.
get_auction_marketsARead-onlyIdempotentInspect
경락 조회에 사용할 수 있는 전국 공영도매시장 코드(예: 110001=서울가락)와 한글명 목록. /api/auction/price 의 market 파라미터에 코드·한글명 모두 사용 가능.
Inputs: no named parameters. Returns: object
get_auction_priceARead-onlyIdempotentInspect
특정 품목의 경락(낙찰) 요약을 반환한다. 단위는 원/kg(거래중량 가중평균).
market 지정: 해당 시장 1곳의 평균 낙찰가·총물량·거래건수·가격범위 + KAMIS 정산 도매가 비교(기준 상이: 경락=낙찰가, KAMIS=정산 도매가).
market 생략: 전 시장을 평균가 오름차순(어디가 싼지)으로 반환.
date 생략: 최신 수집일 자동.
market 매칭: 코드(110001)·한글명(서울가락)·부분일치(가락) 모두 허용. 부분일치 복수 시 후보 목록 반환.
미존재 품목·시장·날짜는 404 아닌 200 + {found:false, hint}.
Inputs: item (required), date, market. Returns: object
get_current_weather_alertsARead-onlyIdempotentInspect
특허 #1 추천 시스템의 사용자 인터페이스 출력. 현재 월에 해당하는 기상 민감 품목별 경보를 자연어 메시지로 반환. AI 에이전트가 그대로 사용자에게 전달 가능한 형태.
action 값 4단계
즉시매입/선매입권고/정상발주/매입지연
Monthly weather alerts for current month, with natural language messages.
Inputs: no named parameters.
get_events_upcomingARead-onlyIdempotentInspect
오늘 기준 향후 horizon_days(기본 14일=D-14 경보) 내 도래하는 명절(설날·추석)과 김장철(11/1~12/15) 이벤트, 그리고 27년 실측 기반 영향 품목 신호를 반환한다.
각 품목 신호는 두 가지로 분리된다:
price: 명절/김장 가격급등 → 선매입(발주 권고 제안) 대상
demand: 수요폭증인데 가격하락(공급폭증) → '매수 적기' 플래그
강도(강/중/약)와 일관성(consistency %)을 함께 노출한다.
Inputs: horizon_days. Returns: object
get_item_event_signalARead-onlyIdempotentInspect
특정 품목의 명절·김장 이벤트 신호를 반환한다. signal_type=price(가격급등 선매입) 또는 demand(가격하락 매수적기).
order_plan_suggestion 은 방식 A '제안형' — 기존 suggest_order_plan (POST /api/predictive-orders/suggest-trigger) 호출용 payload 를 생성만 하며, AI 는 발주를 실행하지 않는다(사람 승인 게이트, 특허 정합).
Inputs: item (required). Returns: object
get_item_price_historyBRead-onlyIdempotentInspect
특정 품목의 최근 N일간 일자별 도매가 시계열을 반환합니다. days 파라미터로 조회 기간 조정(기본 14일).
파라미터
item_name(path, required): 품목명 한글. 예: 배추, 양파, 대파days(query, optional): 조회 일수 (1~365, 기본 14)
Returns daily wholesale price time series for a single item.
Inputs: item_name (required), days. Returns: object
get_seasonal_patternARead-onlyIdempotentInspect
품목별 12개월 평년 가격 흐름입니다. 월값 = 올해 그 달 평일마다 구한 KAMIS 평년(지난 5년 같은 시기 ±3일 평일 평균 중 최고·최저를 뺀 3년 평균)의 평균. 단위는 계열 unit(원/kg 또는 원/개). 평년이 잡힌 평일이 10일 미만인 달은 null. 품목 매핑은 승인된 별칭만 쓰고, C등급 계열은 내지 않습니다(available=false, reason). 매입 시점 권고가 아니라 지난 5년의 계절 흐름입니다.
12-month KAMIS 5-year normal (trimmed mean of 3 of 5 years) per item; low/high month of the normal.
Inputs: no named parameters. Returns: object
get_weather_analysis_short_termBRead-onlyIdempotentInspect
최근 N일간(기본 3일) 실관측 기상 데이터와 가격 변동을 결합한 단기 분석. scatter plot용 데이터 포인트와 자연어 해석(interpretation) 포함.
Combines recent weather observations with price movements for short-term analysis.
Inputs: days, station_id. Returns: object
get_weather_price_correlationBRead-onlyIdempotentInspect
특허 #1 기상×가격 매입 타이밍 추천 시스템의 핵심 데이터. 11년치(2015~2025) KAMIS 가격 + 기상청 ASOS 데이터로 산출한 품목별·월별 피어슨 상관계수 매트릭스.
핵심 필드
yearly_corr[품목][기상변수]:{r, p, n, significant}객체r: 피어슨 상관계수 (-1 ~ +1)p: p-value (0.05 미만이면 통계적 유의)significant: p<0.05 + |r|>=0.7 동시 충족
alert_triggers: 사전 정의된 경보 규칙 14개
Monthly weather-price Pearson correlation matrix (Patent #1 core data).
Inputs: no named parameters.
get_wholesale_pricesARead-onlyIdempotentInspect
v2 신설 — 5대 원칙 #4 데이터 정규화 핵심 엔드포인트. 9개 핵심 품목(배추·무·양파·대파·마늘·오이·감자·생고추·토마토)의 도매가를 품목당 1행 단일 스키마로 반환합니다.
호출 메커니즘
KAMIS
dailyPriceByCategoryList(도매:p_product_cls_code=02) 카테고리 200·100 두 번 호출 · 국가코드 비움 = 조사 도매시장(최대 5곳) 평균각 품목의
(item_code, kind_code, rank_code)매칭으로 단일 행 추출도매 매칭 실패 품목은
dailySalesList(소매)로 자동 fallback
핵심 필드
today,yesterday: 도매가 (KRW, KAMIS 단위 기준)unit: KAMIS 도매시장 표준 단위 (예: '10kg', '100개')kg_per_unit: 단위→kg 환산 계수 (품목 간 비교용)krw_per_kg: kg당 단가 (KRW/kg) — 품목 간 직접 비교 가능한 정규화 가격kg_conversion_note: 환산 근거 자연어 설명 (LLM 컨텍스트용)price_basis:"wholesale"(도매 성공) /"retail_fallback"(소매 대체)as_of: 실제 가격 기준일 (도매시장 마감 전이면 전일)kamis_item_code,kamis_kind_code,kamis_kind_name,kamis_rank: 출처 추적용 메타필드coverage: 9품목 중 도매/소매 fallback/누락 분포
/api/prices와의 차이
/api/prices: 소매가, 다중 단위 중복 가능 (대시보드 호환용)/api/prices/wholesale: 도매가, 9품목, 정규화된 단일 스키마 (LLM/AI용)
Returns normalized wholesale prices (1 row per item) for 9 core items. Falls back to retail when wholesale unavailable (price_basis indicates source).
Inputs: regday.
items_getBRead-onlyIdempotentInspect
표준 품목 하나 — 소스별 식별자·확정 여부·포장 kg 근거(가격 없음)
Inputs: item_id (required).
items_listARead-onlyIdempotentInspect
표준 품목 목록 — 소스별 매핑 신뢰도 요약(가격 없음)
Inputs: no named parameters.
items_resolveARead-onlyIdempotentInspect
자유 텍스트(한/영/일/중 표준명·별칭·소스 원문명) → 표준 품목. 부분 일치 안 함 · 두 축 표기와 근거 포함 · 로트 연결 없음
Inputs: q (required), locale.
lots_reconcileBRead-onlyIdempotentInspect
식별자 정합 — 여러 체계·주체의 품목 코드/로트 코드가 같은 품목·같은 로트를 가리키는지(추론 없음·가격 없음)
Inputs: identifiers (required).
market_calendarBRead-onlyIdempotentInspect
[B2AI] 도매시장 개장/휴장과 다음 개장일.
⛔ Phase 12a 의 판정 함수(receipt_price.market_status)를 그대로 쓴다.
영수증 시세 대조와 이 캘린더가 다른 답을 내면 안 된다.
OPEN=거래 있음 · MARKET_CLOSED=휴장(수집됐으나 거래 0건) · NO_DATA=미수집.
휴장과 미수집을 뭉뚱그리지 않는다.
Inputs: date, days.
market_get_itemARead-onlyIdempotentInspect
품목 상세 — 시세 추이 + 평년 밴드 + 등급/등급사유.
⚠ B·C등급 응답에는 예측 필드가 없습니다(부재). A등급만 forecast_available=true이며 실제 3스케일 방향 예측·신뢰도는 기존 예측 파이프라인이 제공합니다. 반입량·법인집중도는 이번 범위 밖(원자료 확보 후 추가).
Inputs: item_key (required), days.
market_list_itemsARead-onlyIdempotentInspect
전품목 시세 목록. 등급·표기명·최근 시세·전일비·평년비.
A등급=검증된 예측 계열(예측 제공), B등급=시세 상세, C등급=시세 조회. 단가는 KAMIS 도매·상품 정규화가(원/단위, KRW). 반입량 미포함(이번 범위).
Inputs: q, sort, buryu, grade.
market_tickerARead-onlyIdempotentInspect
[B2AI] 시세 티커 — 품목·가격(원/kg)·전일 대비 %.
⛔ 표시 시각과 기준일을 반드시 함께 준다. 어제 값을 실시간처럼 보이게 하지 않는다. 박거래 품목(거래 50건·1,000kg 미만)은 등락률이 노이즈라 제외한다 — 제외 수는 응답에 명시.
Inputs: limit.
mkt_check_deliveryARead-onlyIdempotentInspect
공급자의 신고된 배송 조건으로 지정 시군구 커버 여부를 판정한다. status=SELF(자차)/CARRIER(외부 운송)/PICKUP_ONLY(산지 인도)/NEGOTIATE(미신고 — 결격 아님)/OUT_OF_RANGE(권역 밖·육로 미연결). unit_price_krw·qty_value·qty_unit 을 함께 주면 운임 포함 인도원가와 kg당 인도단가(원/kg)를 같이 계산한다. 좌표·읍면동·주소는 반환하지 않는다. 단위: distance_km_straight 는 킬로미터(km)이며 예상 직선거리입니다(도로거리·소요시간 아님). fee_estimate_krw 는 대한민국 원(KRW) 범위이고 정보가 부족하면 min·max 모두 null 입니다(0원 아님). max_load_kg 는 킬로그램(kg). 모든 배송 정보는 공급자 신고 기준이며 팜템포가 검증하지 않았습니다. 행정구역 경계: 통계청 SGIS(공공누리 제1유형) / 가공: vuski/admdongkor (CC BY 4.0)
Inputs: region (required), supplier_id (required), item, qty_unit, +3 more.
mkt_create_rfq_draftCRead-onlyIdempotentInspect
AI RFQ 초안 — 예측 API로 밴드+근거+신뢰도 등급. 신뢰도 하위 등급이면 밴드 null+사유. sync def(스레드풀 실행) — 같은 :8003 워커로의 예측 자기호출이 이벤트 루프를 막지 않도록.
Inputs: b.
mkt_search_listingsARead-onlyIdempotentInspect
공개 필드만 반환(상호·시군구·품목·규격·등급·출하기간·희망가). 연락처 없음. 단가 KRW. deliverable_to 에 구매자 시군구(코드 5자리 또는 '경기 구리시')를 주면 그 지역까지 배송 가능한 건만 남기고, 각 건에 delivery 객체를 중첩한다 — status/예상 직선거리(킬로미터·직선)/운임 범위(대한민국 원)/인도원가. 미신고 공급자는 배제하지 않고 '배송 협의'로 함께 남는다. deliverable_to 를 주지 않으면 응답은 종전과 동일하다(스키마 무변경).
Inputs: item, region, deliverable_to.
mkt_search_rfqsCRead-onlyIdempotentInspect
OPEN RFQ 목록. farm_id 지정 시 그 농가 조건 적합(품목×권역) = 입찰함(폴링).
Inputs: item, region, farm_id.
onboard_rolesBRead-onlyIdempotentInspect
[B2AI] 팜템포 참여 역할 목록과 각 역할의 개설 상태.
CLOSED 역할은 응답에 포함되지 않는다(가입 경로가 없다).
WAITLIST 는 대기 등록만 가능하며 아직 거래가 열리지 않은 상태다.
Inputs: no named parameters.
onboard_statsARead-onlyIdempotentInspect
[B2AI] 참여 현황 공개 집계 — 역할별·시군구별 실제 건수만.
⛔ 개인 식별 정보(상호·연락처·정확 좌표)는 어떤 필드로도 나가지 않는다. 숫자가 0인 구간도 0으로 그대로 돌려준다(보정·반올림 없음).
Inputs: no named parameters.
predict_demand_for_itemARead-onlyIdempotentInspect
⚠️ 실제 매장 판매·주문 자료로 만든 예측이 아니라 규칙으로 만든 참고값입니다(method='rule-baseline-v1'). 사용자에게 수요 '예측'으로 말하지 말고 '규칙 기반 참고값'이라고 밝히세요. [AGENT_HONESTY 20261011]
품목별 일자 수요량을 마트 거래 단위와 kg 환산으로 동시 반환.
단위 정책
각 수량 필드는 trade_unit_value + trade_unit + kg_equivalent 3중 표현. 외부 AI는 kg_equivalent로 정규화 계산, 마트 UI는 trade_unit_value로 표시. 환산 출처: KAMIS·가락시장 관행 표준.
mart_id
현재 무시. 향후 매장별 모델 + 매장별 단위 환산 계수 오버라이드 예약 필드.
Returns per-day demand forecast in dual units (trade + kg). Method is rule-based heuristic; ML migration planned.
Inputs: item_code (required), mart_id, horizon_days.
region_listBRead-onlyIdempotentInspect
권역별 상태 + 밀도 지표. 실제 카운트만 — 0인 권역도 0으로 표시한다.
Inputs: no named parameters.
tempo_reference_itemsBRead-onlyIdempotentInspect
템포 기준 시세가 있는 품목 목록 (aT 도매 정산가 26품목)
Inputs: no named parameters.
tempo_reference_priceCRead-onlyIdempotentInspect
플랫폼·AI 에이전트가 거래 가격의 기준으로 쓰는 값. 정의가 고정돼 있고(method_version), 출처·기준일을 함께 준다. 납품가는 운송·포장·등급 차이를 계수로 감안할 것. 결정은 사람.
Inputs: item (required).
usda_catalogBRead-onlyIdempotentInspect
팜템포가 재배포 승인을 받아 보유한 USDA AMS Market News 리포트 3종과, 품목별 수록 구간.
Inputs: no named parameters.
usda_latestARead-onlyIdempotentInspect
시장·품목마다 가장 최근 리포트 날짜의 행만.
⛔ 최신 날짜는 시장마다·품목마다 다르다. 한 날짜로 뭉뚱그리지 말고 행마다 report_date 를 읽을 것. ⛔ 도시끼리 합치거나 평균 내지 않는다 — 각자의 시장이다.
Inputs: limit, market, origin, commodity.
usda_movementCRead-onlyIdempotentInspect
보고된 대로의 반입 행. 값은 변형하지 않으며, 행마다 리포트 번호와 리포트 날짜가 붙는다.
Inputs: to, from, limit, offset, +3 more.
usda_movement_catalogBRead-onlyIdempotentInspect
팜템포가 재배포 승인을 받아 보유한 USDA 반입 물량 리포트와, 리포트별 수록 구간.
Inputs: no named parameters.
usda_movement_summaryBRead-onlyIdempotentInspect
선택한 행들의 파운드 합계.
🔴 이 합계는 USDA 가 발표한 수치가 아니라 팜템포가 더한 값이다. 응답의 computed 가 그렇게 밝힌다.
단위는 파운드 그대로 — kg·톤으로 바꾸지 않는다.
Inputs: to, from, limit, origin, +3 more.
usda_pricesARead-onlyIdempotentInspect
보고된 대로의 터미널시장 가격 구간 — 그날 아침 도매시장 첫 수취인(도매업자)의 판매가(USDA 조사). 값은 변형하지 않으며, 행마다 리포트 번호와 리포트 날짜가 붙는다.
Inputs: to, from, limit, market, +3 more.
usda_sp_catalogBRead-onlyIdempotentInspect
팜템포가 재배포 승인을 받아 보유한 USDA 산지(shipping point) 리포트와, 품목별 수록 구간.
Inputs: no named parameters.
usda_sp_latestBRead-onlyIdempotentInspect
리포트·품목마다 가장 최근 리포트 날짜의 행만.
⛔ 산지는 계절 따라 돈다 — 제철이 아닌 산지는 최신 날짜가 몇 달 전일 수 있다. 행마다 report_date 를 읽을 것.
Inputs: limit, report, commodity.
usda_sp_pricesCRead-onlyIdempotentInspect
보고된 대로의 산지 FOB 가격 구간. 값은 변형하지 않으며, 행마다 리포트 번호와 리포트 날짜가 붙는다.
Inputs: to, from, limit, offset, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Korean wholesale agriculture market data - auction prices, seasonal produce, market trends
Search KR/US products, dated options and unit prices; original merchant affiliate purchase links.
Read-only catalog of a Korean farm-produce shop: search products, prices, origin facts, guides.
Korean product prices and rankings from Naver Shopping, Olive Young and Daiso. Pay per result.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceMCP server for Korean agricultural wholesale market real-time auction data from 32+ markets with 63K+ daily records via data.go.kr public API.MIT
- AlicenseNot gradedqualityDmaintenanceReal-time Korean cryptocurrency data via Upbit exchange — kimchi premium, live prices, top movers, and exchange comparison.MIT
- AlicenseAqualityBmaintenanceKorean blue chips (Samsung Electronics, SK hynix, Hyundai Motor) priced 24/7 from Hyperliquid perps in KRW: the pre-open price after the US close with how often the KRX open followed that direction, and cost-adjusted arbitrage between the Korean market and Hyperliquid. Order previews only. MIT licensed.5MIT
- FlicenseNot gradedqualityCmaintenanceProvides agricultural product price monitoring, price index tracking, and daily/weekly/monthly market report queries to support price fluctuation identification and market trend analysis.1-
Glama MCP Gateway
Add one secure layer between your agents and this server.