Sienna, Knobs.co hardware advisor

Knobs.co cabinet-hardware advisor: sizing, fits, finishes, prices, plans, cart and sample links.

Should I use this

Quality & Safety

A
Description quality
95%
Schema completeness
86%
Naming quality
91%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (1)

  • LOWTool 'store_info' description lacks action verbin store_info

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~2,839Tokens (tool definitions)
~1.7 KBTypical response size
Significant attention impact (2.22% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "sienna": {
      "url": "https://sienna.knobs.co/mcp"
    }
  }
}

Remote endpoints

https://sienna.knobs.co/mcpstreamable-http

What it can do

Tool inventory

Tools (11)

🟒 Read-only🟑 WriteπŸ”΄ Deleteβšͺ Unknown
🟒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.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
🟒search(query)

Search Knobs.co products. Returns {results:[{id,title,url}]} where id is the product handle for fetch.

Input Schema

{
  "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}.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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.

Input Schema

{
  "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
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded11 tools