coffee-price-mcp
This server helps you find and evaluate the cheapest coffee deals in Korea by calculating the real out-of-pocket price (list price minus discounts) across major Korean coffee brands (Starbucks, Mega, Compose, Twosome, Coffeebean, Blue Bottle, Hollys, Ediya, Paik, The Venti, Gong Cha).
Find the cheapest coffee (
get_cheapest_coffee): Rank the top N cheapest coffees by effective price, optionally filtered by your memberships/cards (e.g., SKT, 현대카드), specific menu (e.g., 아메리카노), and/or specific brands.Search coffee deals (
search_coffee_deals): Filter deals by brand, telecom carrier or card issuer, benefit type (coupon, freebie, discount, etc.), keyword, or today-only offers. Each result includes the calculated effective price.Verify receipt price (
verify_receipt_price): Check if the price you paid at a specific brand was great, fair, or overpaid compared to today's best deals, with suggestions for better offers you could have used.Get card benefits: View benefits by card, carrier, or payment method, showing immediate discounts as effective prices and cashback/points for reference.
Allows OpenAI Codex CLI to find the cheapest coffee deals from Korean brands, search for discounts, and verify receipt prices via read-only MCP tools.
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., "@coffee-price-mcp what's the cheapest coffee today?"
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.
☕ coffee-price-mcp
"오늘 커피 가장 싸게 먹는 법" — read-only MCP 서버.
An MCP server that ranks today's cheapest coffee in Korea by real out-of-pocket price (list price − telecom/card/coupon perks). Plugs into Claude Code, OpenAI Codex, and Gemini CLI in one line.
coffee.pryzm.gg 의 공개 브랜드 혜택 API(/coffeecong/brand-benefits/*)를 감싸고, 브랜드별 메뉴 정가 상수로 체감가(정가 − 할인) 를 계산해 랭킹합니다. DB·시크릿 없음 — 공개 API만 호출하는 얇은 래퍼라서 그대로 가져다 쓰면 됩니다.
🔗 소개 페이지: coffee.pryzm.gg/coffee/mcp.html · 데모: AI에 연결하고 "오늘 제일 싼 커피는?" 한마디면 끝.
🚀 빠른 연결 (설치 불필요)
세 도구 모두 아래 한 가지 실행 명령을 공유합니다:
npx -y github:jeonghwanko/coffee-price-mcpNode.js 18+ 만 있으면 됩니다. 최초 실행 시 GitHub에서 받아 자동 빌드하므로 몇 초 걸리고, 이후 캐시됩니다.
Claude Code
가장 간단 — 터미널에서:
claude mcp add coffee-price -- npx -y github:jeonghwanko/coffee-price-mcp또는 .mcp.json(프로젝트) / ~/.claude.json(전역)에 직접:
{
"mcpServers": {
"coffee-price": {
"command": "npx",
"args": ["-y", "github:jeonghwanko/coffee-price-mcp"]
}
}
}OpenAI Codex CLI
~/.codex/config.toml 에 추가:
[mcp_servers.coffee-price]
command = "npx"
args = ["-y", "github:jeonghwanko/coffee-price-mcp"]Gemini CLI
~/.gemini/settings.json 에 추가:
{
"mcpServers": {
"coffee-price": {
"command": "npx",
"args": ["-y", "github:jeonghwanko/coffee-price-mcp"]
}
}
}연결 후 "오늘 제일 싼 커피는?" 이라고 물어보면 됩니다.
Related MCP server: cafe-mcp-server
📋 예시
AI에게 평소 말투로 물어보면, AI가 get_cheapest_coffee 를 호출해 이렇게 답합니다:
🙋 오늘 제일 싼 커피는?
🤖 오늘 기준 아메리카노 체감가 TOP 3예요.
🥇 할리스커피 0원 (정가 4,100) — KT VVIP, 아메리카노 2잔 무료
🥈 스타벅스 0원 (정가 4,500) — LG U+ VVIP/VIP, 1잔 무료
🥉 컴포즈커피 1,000원 (정가 1,500) — 조건 없음, 누구나
👉 멤버십이 없다면 컴포즈 1,000원이 사실상 최저가예요.멤버십/카드를 알려주면 본인이 받을 수 있는 혜택만 골라 다시 랭킹합니다:
🙋 나 SKT랑 현대카드 있어. 오늘 라떼 싸게 마시려면?🛠 Tools (모두 read-only)
tool | 설명 | 주요 인자 |
| 오늘 가장 싸게 먹을 수 있는 커피 TOP N. 체감가 오름차순. |
|
| 혜택 검색/필터. 각 혜택에 체감가 주석. |
|
| 내가 낸 가격 적정성 점검 → great/fair/overpaid + 더 나은 혜택 제시. |
|
| 카드사·통신사·페이별 혜택 모아보기. 즉시 할인은 체감가로, 캐시백·적립은 정보성으로 노출. |
|
지원 브랜드: starbucks, mega, compose, twosome, coffeebean, bluebottle, hollys, ediya, paik, theventi, gongcha
🧮 체감가 엔진 (src/pricing.ts)
실데이터상 discountPct가 거의 항상 null이라 제목 텍스트 파싱이 핵심입니다:
명시적
discountPct→정가 × (1 − pct/100)(신뢰도 high)무료 음료 ('음료' 인접 '무료/증정') → 0원
퍼센트 ("최대 20%")
BOGO ("1+1", "2+1") → 음료당 환산
정액 ("500원 할인")
산정 불가 → 랭킹 제외
원두·MD·굿즈 등 음료가 아닌 대상의 할인은 제외합니다(제목 가드). 마케팅 요약은 오탐이 잦아 파싱에서 제외.
⚠️ 체감가는 정가(코드 상수) − 혜택(제목 파싱) 추정치입니다. 등급·선착순·중복 불가 등 실제 적용 조건은 각 혜택의
sourceUrl을 확인하세요. 정가는 2026 기준 근사값입니다.
⚙️ 환경변수
변수 | 기본값 | 설명 |
|
| 혜택 API 베이스. 로컬 개발 시 |
config의 env 블록으로 덮어쓸 수 있습니다:
{
"command": "npx",
"args": ["-y", "github:jeonghwanko/coffee-price-mcp"],
"env": { "COFFEE_API_BASE": "https://coffee.pryzm.gg/api" }
}🧑💻 로컬 개발
git clone https://github.com/jeonghwanko/coffee-price-mcp.git
cd coffee-price-mcp
npm install
npm run build # tsc → dist/
npm test # vitest (pricing/engine 테스트)
npm start # node dist/index.js (stdio)소스에서 직접 실행하도록 config를 바꾸려면:
{ "command": "node", "args": ["/절대/경로/coffee-price-mcp/dist/index.js"] }📦 npm 게시 (선택)
npx github: 방식은 매 실행마다 GitHub에서 받아 빌드합니다. 더 빠른 시작을 원하면 npm에 게시하세요:
npm publish --access public게시 후에는 모든 config에서 github:jeonghwanko/coffee-price-mcp 를 coffee-price-mcp 로 바꾸면 됩니다.
라이선스
MIT · 데이터 출처: coffee.pryzm.gg 공개 혜택 API
Available Tools
3 toolsget_cheapest_coffeeA
오늘 가장 싸게 먹을 수 있는 커피 TOP N. 보유 멤버십/카드를 주면 받을 수 있는 혜택만 골라 체감가(정가-할인) 오름차순으로 랭킹한다.
Inputs: memberships, menu, brands, limit.
search_coffee_dealsB
커피 혜택 검색/필터 (브랜드·통신사/카드사·유형·키워드·오늘만). 각 혜택의 체감가를 함께 반환한다.
Inputs: query, brand, provider, benefitType, +2 more.
verify_receipt_priceA
내가 낸 커피 가격이 적정한지 점검. 정가와 오늘 최저 체감가를 비교해 great/fair/overpaid 판정 + 더 나은 혜택을 제시한다. (영수증 제출이 아니라 가격 점검용 read-only)
Inputs: brand (required), paidPrice (required), menu.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: get_cheapest_coffee ranks top deals based on user memberships, search_coffee_deals provides flexible filtering, and verify_receipt_price checks a given price against current deals. No overlap or ambiguity.
All tools use the verb_noun pattern in snake_case: get_cheapest_coffee, search_coffee_deals, verify_receipt_price. The convention is perfectly consistent.
With 3 tools, the count is slightly low but appropriate for a focused price-checking domain. Each tool earns its place, and expanding to 4-5 would not harm, but the current count is reasonable.
The tools cover key operations: retrieving cheapest options, searching/filtering deals, and verifying a receipt price. Minor gaps exist, such as lacking a tool to list all brands or deals without filtering, but the core workflows are well-supported.
Related MCP Connectors
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Free hosted MCP server: US healthcare procedure cost estimates and provider pricing. No API key.
Read-only MCP server for The Quiet Protocol's engines, benchmarks, proof, and business data.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that finds great espresso cafes using a curated database of specialty coffee shops and a transparent scoring algorithm, with a strong bias against flavored syrups and mass-market chains.653 npmMIT
- FlicenseAqualityDmaintenanceMCP server that recommends coffee based on preferences (mood, milk, caffeine, temperature) from a static menu; includes tools for listing menu, recommending, and explaining recommendations.3-
- AlicenseAqualityDmaintenanceAn MCP server that tells an AI assistant what's on sale at grocery stores near any US ZIP code by reading weekly circulars and providing fast, queryable deal data.28MIT
- AlicenseNot gradedqualityAmaintenanceMCP server for the Roastify Developer API, letting AI agents browse the coffee catalog and generate packaging artwork, with paid tools settled in Bitcoin Lightning.Apache 2.0