Percolate
Search the Percolate specialty coffee database: 1,100+ coffees with brew recipes and pairings.
사용해야 할까요
품질 및 안전성
발견 사항 (2)
- LOWcompare_coffees에서
- LOWwhat_to_brew에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"percolate": {
"command": "npx",
"args": [
"percolate-mcp"
]
}
}
}실행 가능한 패키지
1.0.2stdio원격 엔드포인트
https://wmpiabzlcaqyrzxvfihi.supabase.co/functions/v1/mcpstreamable-httphttps://mcp.percolateapp.com/?src=registrystreamable-http할 수 있는 일
도구 목록
도구 (8)
🟢search_coffees(query, category, roast_level, brew_method, price_min, ...)
Search 1,100+ curated specialty coffees in the Percolate database. Filter by category (espresso, single_origin, blend, decaf, dark), roast level, brew method, and price (USD). Returns tasting profiles, brew methods, and where-to-buy links.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 120,
"description": "Free-text search: coffee or roaster name"
},
"category": {
"type": "string",
"enum": [
"espresso",
"single_origin",
"blend",
"decaf",
"dark"
],
"description": "Coffee category to filter by; omit to search all"
},
"roast_level": {
"type": "string",
"enum": [
"light",
"medium-light",
"medium",
"medium-dark",
"dark"
],
"description": "Roast level to filter by; omit to include all roasts"
},
"brew_method": {
"type": "string",
"maxLength": 120,
"description": "e.g. 'espresso', 'pourover', 'french press', 'drip'"
},
"price_min": {
"type": "number",
"minimum": 0,
"description": "Minimum price in USD"
},
"price_max": {
"type": "number",
"minimum": 0,
"description": "Maximum price in USD"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"description": "Max results (default 10, max 10)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_coffee(id_or_name)
Detailed record for one coffee: roast level, body/acidity/sweetness profile, flavor notes, suited brew methods, food and brew pairings, price, and retailer links. Accepts a Percolate id or a name.
입력 스키마
{
"type": "object",
"properties": {
"id_or_name": {
"type": "string",
"maxLength": 120,
"description": "Coffee id or a name like 'Bean Box Taste of New York City'"
}
},
"required": [
"id_or_name"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢find_similar(coffee, limit)
Coffees with a similar profile to a given one, ranked by shared flavor notes and roast/body/acidity/sweetness proximity. Deterministic scoring over Percolate's structured tasting data.
입력 스키마
{
"type": "object",
"properties": {
"coffee": {
"type": "string",
"maxLength": 200,
"description": "Coffee id or name"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"description": "Max results (default 5)"
}
},
"required": [
"coffee"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_recommendations(preferences, budget, roast_level, brew_method, limit)
Personalized coffee picks from flavor preferences (e.g. 'chocolate', 'berry', 'caramel'), a budget in USD, roast preference, and the brew gear you own.
입력 스키마
{
"type": "object",
"properties": {
"preferences": {
"type": "array",
"items": {
"type": "string",
"maxLength": 60
},
"minItems": 1,
"maxItems": 20,
"description": "Flavors the drinker enjoys, e.g. ['chocolate','caramel','nutty']"
},
"budget": {
"type": "number",
"minimum": 0,
"description": "Max price in USD per bag"
},
"roast_level": {
"type": "string",
"enum": [
"light",
"medium-light",
"medium",
"medium-dark",
"dark"
],
"description": "Roast level to filter by; omit to include all roasts"
},
"brew_method": {
"type": "string",
"maxLength": 120,
"description": "What you brew with, e.g. 'espresso', 'pourover'"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"description": "Max results (default 5)"
}
},
"required": [
"preferences"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢compare_coffees(coffee_a, coffee_b)
Side-by-side comparison: roast, body/acidity/sweetness, shared and distinct flavors, brew methods, and price difference.
입력 스키마
{
"type": "object",
"properties": {
"coffee_a": {
"type": "string",
"maxLength": 200,
"description": "First coffee — id or name"
},
"coffee_b": {
"type": "string",
"maxLength": 200,
"description": "Second coffee — id or name"
}
},
"required": [
"coffee_a",
"coffee_b"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢trending_coffees(limit)
Coffees Percolate users are adding to their collections most over the last 30 days (falls back to catalog popularity when live activity data is unavailable). The method used is labeled in the response.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"description": "Max results (default 10, max 10)"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢dial_in_suggestion(coffee, brew_method)
Brew guidance for a specific coffee: curated recipes from the Percolate catalog (ratio, temperature, grind) when available, or a roast-based starting point. Optionally scoped to your brew method.
입력 스키마
{
"type": "object",
"properties": {
"coffee": {
"type": "string",
"maxLength": 200,
"description": "Coffee id or name"
},
"brew_method": {
"type": "string",
"maxLength": 120,
"description": "Your brewer, e.g. 'V60', 'espresso', 'french press'"
}
},
"required": [
"coffee"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢what_to_brew(time_of_day, mood, brew_method)
A coffee suggestion for right now, based on time of day (evening picks lean decaf), mood, and the brew method you're using — scored over Percolate's tasting profiles.
입력 스키마
{
"type": "object",
"properties": {
"time_of_day": {
"type": "string",
"enum": [
"morning",
"afternoon",
"evening"
],
"description": "When the coffee will be drunk — shifts the pick toward lighter or lower-caffeine options later in the day"
},
"mood": {
"type": "string",
"maxLength": 120,
"description": "e.g. 'need focus', 'lazy weekend', 'something comforting', 'adventurous'"
},
"brew_method": {
"type": "string",
"maxLength": 120,
"description": "What you're brewing with"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}커뮤니티
증거