Sienna, Knobs.co hardware advisor
Knobs.co cabinet-hardware advisor: sizing, fits, finishes, prices, plans, cart and sample links.
사용해야 할까요
품질 및 안전성
발견 사항 (1)
- LOWstore_info에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"sienna": {
"url": "https://sienna.knobs.co/mcp"
}
}
}원격 엔드포인트
https://sienna.knobs.co/mcpstreamable-http할 수 있는 일
도구 목록
도구 (11)
🟢ask_sienna(question)
Ask Knobs.co's automated cabinet-hardware advisor one question in plain words and get one complete answer with the exact products named (title, vendor, finish, size, list price, URL). Best for: which pull length for a drawer width, what fits existing holes (center-to-center), knobs versus pulls, finish and style pairing, a series in a size/finish/budget, samples, returns, the trade program. Include everything known: room, drawer widths, existing hole spacing, finish, style, budget per piece, brand likes or dislikes. One question per call; up to 600 characters.
입력 스키마
{
"type": "object",
"properties": {
"question": {
"type": "string",
"description": "The shopper's question, with what is known."
}
},
"required": [
"question"
],
"additionalProperties": false
}🟢search_catalog(query)
Search the live Knobs.co catalog by item type, size, finish, brand or series ("5 inch pull satin nickel", "Top Knobs Lynwood", "3 inch matte black pull"). Returns up to 10 products with vendor, center-to-center size, overall length, finishes, list prices, variant ids and product URLs. Sizes and finishes in the query are matched exactly when possible, then nearest sizes.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Plain words: item type + size + finish, or brand + series."
}
},
"required": [
"query"
],
"additionalProperties": false
}🟢get_product(handle)
Every variant (finish, SKU, list price, variant id) of one product by its handle (from search_catalog or a knobs.co/products/<handle> URL), with sizes and description.
입력 스키마
{
"type": "object",
"properties": {
"handle": {
"type": "string",
"description": "The product handle, e.g. \"atlas-homewares-a656-whittier-pull-8-13-16-cc\"."
}
},
"required": [
"handle"
],
"additionalProperties": false
}🟢sizing_guide
Knobs.co's sizing rules: which pull length for which drawer width, the standard 128 mm size, knobs versus pulls, one pull or two, and how to measure existing holes. No arguments.
입력 스키마
{
"type": "object",
"properties": {},
"additionalProperties": false
}🟢store_info
What Knobs.co is, what it sells, how to buy, samples, trade program, how to reach a person, and how this service works. No arguments.
입력 스키마
{
"type": "object",
"properties": {},
"additionalProperties": false
}🟢search(query)
Search Knobs.co products. Returns {results:[{id,title,url}]} where id is the product handle for fetch.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Plain-words product search: item type, size, finish, brand or series (e.g. \"3 inch matte black pull\")."
}
},
"required": [
"query"
],
"additionalProperties": false
}🟢fetch(id)
Fetch one Knobs.co product document by id (the handle from search). Returns {id,title,text,url,metadata}.
입력 스키마
{
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "The product id returned by search (the knobs.co product handle)."
}
},
"required": [
"id"
],
"additionalProperties": false
}🟡build_plan(answers, candidates, summary)
Build the shopper's whole-kitchen (or bath) Hardware Plan: one line per zone (doors, drawers by width, island, tall, appliance panels) with the exact Knobs.co product, finish, size, count and list price, totals, the pieces that qualify as samples, and what is still unconfirmed. Use it once the shopper has given counts, drilling (existing holes or fresh), finish, style and a budget; include products they liked from search_catalog as candidates. The plan is saved for 90 days at the returned plan_url, where the shopper can see it and add its samples or the whole plan to their cart. To change counts, finish or products, call build_plan again with the corrected answers; for Kayla's review, request_consultation with the plan_url. No email or account needed. Costs real money on our side, so call it once per shopper, after the facts are gathered.
입력 스키마
{
"type": "object",
"properties": {
"answers": {
"type": "object",
"additionalProperties": false,
"description": "What the shopper has told the agent about the project. Every field is optional, but the plan needs at least the counts, the drilling situation and the finish.",
"properties": {
"scope": {
"type": "string",
"description": "the project in a few words (\"kitchen remodel, 28 doors and 14 drawers\", \"two bath vanities\")"
},
"drilling": {
"type": "string",
"enum": [
"existing",
"fresh",
"mixed",
"unknown"
],
"description": "existing = holes already drilled (give existing_c2c_text); fresh = new cabinets or new holes"
},
"existing_c2c_text": {
"type": "string",
"description": "the existing hole spacing exactly as the shopper said it (\"3 inches\", \"96 mm\"); \"\" if none"
},
"doors": {
"type": "integer",
"minimum": 0,
"maximum": 500,
"description": "cabinet doors that get a knob or pull (not drawers, not tall/pantry doors)"
},
"drawers_lt18": {
"type": "integer",
"minimum": 0,
"maximum": 500,
"description": "drawers under 18 inches wide"
},
"drawers_18_30": {
"type": "integer",
"minimum": 0,
"maximum": 500,
"description": "drawers 18 to 30 inches wide"
},
"drawers_gt30": {
"type": "integer",
"minimum": 0,
"maximum": 500,
"description": "drawers over 30 inches wide"
},
"tall": {
"type": "integer",
"minimum": 0,
"maximum": 500,
"description": "tall or pantry doors"
},
"appliance_panels": {
"type": "integer",
"minimum": 0,
"maximum": 500,
"description": "panel-front appliances (dishwasher, refrigerator) that get a pull"
},
"style": {
"type": "string",
"description": "shaker, modern, traditional, farmhouse, transitional…"
},
"finish": {
"type": "string",
"description": "the finish they want (matte black, satin nickel, brushed brass…)"
},
"knobs_vs_pulls": {
"type": "string",
"description": "\"all pulls\", \"knobs on doors, pulls on drawers\", \"all knobs\", or what they said"
},
"budget_tier": {
"type": "string",
"description": "per piece, in their words (\"under $8\", \"$10–20\", \"no limit\")"
},
"timing": {
"type": "string",
"description": "when they need the hardware, in their words (\"this week\", \"cabinets arrive in March\", \"no rush\")"
},
"trade": {
"type": "boolean",
"description": "true for a designer, contractor or cabinet shop"
},
"notes": {
"type": "string",
"description": "anything else that matters: island, brands liked or disliked, must-match items, measurements"
}
}
},
"candidates": {
"type": "array",
"maxItems": 12,
"description": "products the shopper liked or the agent found with search_catalog (handle + variant_id in the right finish), optionally with the zone and count they are for",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"handle"
],
"properties": {
"handle": {
"type": "string",
"description": "the product handle from search_catalog or get_product"
},
"variant_id": {
"type": "string",
"description": "numeric Shopify variant id of the finish they want (from get_product); omit to let the plan pick the finish"
},
"zone": {
"type": "string",
"description": "where it goes: \"doors\", \"drawers\", \"island\", \"tall\", \"appliance_panels\", or \"any\""
},
"count": {
"type": "integer",
"minimum": 0,
"maximum": 500,
"description": "how many pieces this candidate covers, if known"
}
}
}
},
"summary": {
"type": "string",
"maxLength": 1500,
"description": "two to six sentences of what the shopper told you, in their words where possible (shown to Kayla if they later ask for a review)"
}
},
"required": [
"answers"
],
"additionalProperties": false
}🟢cart_link(items, plan_url, note)
Turn chosen variants and quantities into a Knobs.co cart link the shopper opens to check out (the cart is pre-filled; they review it, add shipping and pay on knobs.co; nothing is ordered by this call). Variant ids come from search_catalog, get_product or build_plan. Returns the line items with list prices and the subtotal, so you can show the shopper exactly what the cart holds.
입력 스키마
{
"type": "object",
"properties": {
"items": {
"type": "array",
"minItems": 1,
"maxItems": 50,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"variant_id",
"quantity"
],
"properties": {
"variant_id": {
"type": "string",
"description": "numeric Shopify variant id (from search_catalog, get_product or build_plan)"
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 500,
"description": "how many of this variant to put in the cart"
}
}
},
"description": "the variants and quantities to pre-fill in the cart"
},
"plan_url": {
"type": "string",
"description": "the plan_url from build_plan, if this cart comes from a plan"
},
"note": {
"type": "string",
"maxLength": 300,
"description": "an optional note for the order (shown to our team)"
}
},
"required": [
"items"
],
"additionalProperties": false
}🟢start_samples(plan_url, variant_ids)
Pick the pieces that qualify as samples (listed at $20 or under, under 7 inches overall, not a made-to-order line) from a plan or from given variant ids, and return a cart link with one of each plus the sample terms. Samples are bought at the normal price; after the full order the shopper emails both order numbers to [email protected] and up to two samples they did not choose are credited back. Pieces that do not qualify are returned with the reason.
입력 스키마
{
"type": "object",
"properties": {
"plan_url": {
"type": "string",
"description": "the plan_url from build_plan: samples are taken from that plan"
},
"variant_ids": {
"type": "array",
"maxItems": 12,
"items": {
"type": "string",
"description": "numeric Shopify variant id"
},
"description": "or specific variant ids to check for sample eligibility (give plan_url or variant_ids, not both)"
}
},
"additionalProperties": false
}🔴request_consultation(email, name, kind, message, plan_url, ...)
Ask Kayla, Knobs.co's Trade Manager (twenty years in cabinet hardware), to review the shopper's plan by email within one business day, or to set up a call. Only with the shopper's email and their clear agreement to be contacted. This sends the shopper ONE email with a confirmation link; Kayla receives the request only after they click it (within 7 days), so tell the shopper to look for an email from [email protected] and confirm. Include the plan_url from build_plan when there is one, and say in message what they want Kayla to do.
입력 스키마
{
"type": "object",
"properties": {
"email": {
"type": "string",
"description": "the shopper's email, given by them for this purpose"
},
"name": {
"type": "string",
"maxLength": 80,
"description": "the shopper's name as they gave it (first name is enough)"
},
"kind": {
"type": "string",
"enum": [
"review",
"call"
],
"description": "review = Kayla reviews the plan and emails back; call = Kayla sets up a call (the confirmation page opens her calendar)"
},
"message": {
"type": "string",
"maxLength": 1500,
"description": "what the shopper wants from Kayla, in their words, plus anything she needs to know (no links)"
},
"plan_url": {
"type": "string",
"description": "the plan_url from build_plan, when there is a plan"
},
"phone": {
"type": "string",
"maxLength": 40,
"description": "phone number, only if the shopper offered it (useful when kind is \"call\")"
}
},
"required": [
"email",
"message"
],
"additionalProperties": false
}커뮤니티
증거