Sienna, Knobs.co hardware advisor MCP Server

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.

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.

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.

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.

Fetch one Knobs.co product document by id (the handle from search). Returns {id,title,text,url,metadata}.

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.

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.

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

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.

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.

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.