{"serverInfo":{"name":"jenni-shopping","version":"2.0.0"},"name":"jenni-shopping","title":"JENNi Shop Local","version":"2.0.0","description":"Find products for shoppers across the US. Verify local delivery or ship-to-home for the shopper's ZIP and show only modes currently available. JENNi selects the source internally; the shopper checks out on JENNi.","websiteUrl":"https://shop.jennipro.com","transport":{"type":"streamable-http","url":"https://shop.jennipro.com/mcp","endpoints":["https://shop.jennipro.com/mcp","https://shop.jennipro.com/public/v1/agent/mcp"]},"protocolVersions":["2025-06-18","2025-03-26"],"authentication":{"type":"none","required":false},"capabilities":{"tools":{"listChanged":false}},"tools":[{"name":"search_catalog","title":"Search products","description":"Search in-stock products JENNi can deliver to a 5-digit US ZIP: local delivery first, then ship-to-home. Every product returned can be ordered; price is per unit, before the delivery or shipping fee. A product with variants and no price is a size or colour family: buy one of its variants. Sized goods are often listed one size per product: put the size in the query and match it against size or title. Put a price limit in max_price, not the query; keep the query to brand, product type and size. If it returns product_not_found, search once more with fewer words before telling the shopper nothing matched. Pass fulfillment_mode to search one mode. More results: call again with page+1 while page < paging.total_pages.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"title":"Search products"},"inputSchema":{"type":"object","additionalProperties":false,"properties":{"query":{"type":"string","description":"What the shopper wants, e.g. \"running shoes\"."},"zip":{"type":"string","description":"5-digit US ZIP code the shopper is in, e.g. 78205."},"market":{"type":"string","description":"Market key, e.g. san-antonio-tx. Used when no zip is given."},"limit":{"type":"integer","minimum":1,"maximum":20,"description":"Products to return (default 10)."},"page":{"type":"integer","minimum":1,"maximum":42,"description":"1-based results page; call again with page+1 while page < paging.total_pages."},"max_price":{"type":"number","exclusiveMinimum":0,"description":"Highest price the shopper will pay, in US dollars, e.g. 120. Put a price limit here, not in the query."},"fulfillment_mode":{"type":"string","enum":["local_delivery","ship_to_home"],"description":"Search one mode only. Omit to list local delivery first, filled with ship-to-home."}},"required":["query"]},"outputSchema":{"type":"object","properties":{"products":{"type":"array","items":{"type":"object","properties":{"product_id":{"type":"string"},"title":{"type":"string"},"brand":{"type":"string"},"price":{"type":"string","description":"Unit price in USD, before the delivery or shipping fee. Absent on a size or colour family: pick a variant."},"fulfillment":{"type":"string","enum":["local_delivery","ship_to_home"]},"delivery_promise":{"type":"string","description":"Local delivery: \"Get it today\" or \"We'll deliver by <Month D>\". Ship-to-home: \"Ships to you\"."},"size":{"type":"string","description":"Absent when none is recorded; the size may then be in the title."},"color":{"type":"string"},"category":{"type":"string"},"image":{"type":"string"},"variants":{"type":"array","description":"Sizes or colours, each with its own product_id. For a family (no price), get_buying_options and start_checkout need a variant's product_id.","items":{"type":"object","properties":{"product_id":{"type":"string"},"size":{"type":"string"},"color":{"type":"string"}},"required":["product_id"]}},"url":{"type":"string","description":"Product page on JENNi, already carrying the shopper's ZIP."}},"required":["product_id","title"]}},"paging":{"type":"object","properties":{"page":{"type":"integer"},"total_pages":{"type":"integer"},"total_matches":{"type":"integer"}}},"reason_code":{"type":"string","enum":["no_price","no_live_offer","out_of_stock","not_served_locally","variant_required","product_not_found","invalid_input","fee_unavailable","price_unavailable","catalog_unavailable","rate_limited","not_checked","no_buyable_offer"],"description":"Present only when products is empty."},"note":{"type":"string","description":"What could not be checked (for example local delivery): that availability is unknown, not unavailable."}},"required":["products"]}},{"name":"get_product","title":"Product details","description":"Details for one product_id: description, images, sizes and colours, and its price and delivery at the ZIP.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"title":"Product details"},"inputSchema":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string"},"zip":{"type":"string","description":"5-digit US ZIP code, for local prices and delivery options."},"market":{"type":"string","description":"Market key, e.g. san-antonio-tx. Used when no zip is given."}},"required":["product_id"]},"outputSchema":{"type":"object","properties":{"product":{"type":"object","properties":{"product_id":{"type":"string"},"title":{"type":"string"},"brand":{"type":"string"},"price":{"type":"string","description":"Unit price in USD, before the delivery or shipping fee. Absent on a size or colour family: pick a variant."},"fulfillment":{"type":"string","enum":["local_delivery","ship_to_home"]},"delivery_promise":{"type":"string","description":"Local delivery: \"Get it today\" or \"We'll deliver by <Month D>\". Ship-to-home: \"Ships to you\"."},"size":{"type":"string","description":"Absent when none is recorded; the size may then be in the title."},"color":{"type":"string"},"category":{"type":"string"},"image":{"type":"string"},"images":{"type":"array","items":{"type":"string"}},"description":{"type":"string"},"variants":{"type":"array","description":"Sizes or colours, each with its own product_id. For a family (no price), get_buying_options and start_checkout need a variant's product_id.","items":{"type":"object","properties":{"product_id":{"type":"string"},"size":{"type":"string"},"color":{"type":"string"}},"required":["product_id"]}},"url":{"type":"string","description":"Product page on JENNi, already carrying the shopper's ZIP."},"reason_code":{"type":"string","enum":["no_price","no_live_offer","out_of_stock","not_served_locally","variant_required","product_not_found","invalid_input","fee_unavailable","price_unavailable","catalog_unavailable","rate_limited","not_checked","no_buyable_offer"],"description":"Machine-readable reason, alongside the prose note."}},"required":["product_id","title"]}},"required":["product"]}},{"name":"start_checkout","title":"Start checkout","description":"Returns a hosted checkout_url for an exact product and selected fulfillment mode using the delivery address. JENNi selects the source internally. The buyer reviews delivery, tax and the total, enters payment details, and places the order on the hosted page. This read-only tool creates no order, reservation or charge. The final checkout page verifies current price and availability.","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"title":"Start checkout"},"inputSchema":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","description":"The exact item: a variant's product_id when it has variants."},"fulfillment_mode":{"type":"string","enum":["local_delivery","ship_to_home"],"description":"Selected fulfillment mode: local_delivery arrives on the delivery date the buying-options read returns (delivery_promise / deliver_by); ship_to_home ships to the delivery address."},"delivery_address":{"type":"object","additionalProperties":false,"properties":{"address1":{"type":"string"},"address2":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"postal_code":{"type":"string","description":"5-digit US delivery ZIP code."}},"required":["postal_code"],"description":"Delivery destination. Address details are not placed in the checkout URL."}},"required":["product_id","fulfillment_mode","delivery_address"]},"outputSchema":{"type":"object","properties":{"checkout_url":{"type":"string"},"product_id":{"type":"string"},"item":{"type":"string"},"quantity":{"type":"integer"},"fulfillment_mode":{"type":"string","enum":["local_delivery","ship_to_home"]},"delivery_promise":{"type":"string","description":"Local delivery: \"Get it today\" or \"We'll deliver by <Month D>\". Ship-to-home: \"Ships to you\"."},"pricing":{"type":"object","description":"unit_price x quantity + fee = total_before_tax. Sales tax is added at checkout.","properties":{"quantity":{"type":"integer"},"unit_price":{"type":"string"},"subtotal":{"type":"string","description":"unit_price x quantity, when quantity > 1."},"fee":{"type":"string","description":"Local delivery fee or flat shipping."},"total_before_tax":{"type":"string"},"eta":{"type":"object","properties":{"earliest_date":{"type":"string"},"latest_date":{"type":"string"}}},"reason_code":{"type":"string","enum":["no_price","no_live_offer","out_of_stock","not_served_locally","variant_required","product_not_found","invalid_input","fee_unavailable","price_unavailable","catalog_unavailable","rate_limited","not_checked","no_buyable_offer"],"description":"Machine-readable reason, alongside the prose note."},"note":{"type":"string"}}},"unit_price":{"type":"string"},"reason_code":{"type":"string","enum":["no_price","no_live_offer","out_of_stock","not_served_locally","variant_required","product_not_found","invalid_input","fee_unavailable","price_unavailable","catalog_unavailable","rate_limited","not_checked","no_buyable_offer"],"description":"Machine-readable reason, alongside the prose note."},"next_step":{"type":"string"}},"required":["checkout_url","next_step"]}},{"name":"get_buying_options","title":"Check price and delivery","annotations":{"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"title":"Check price and delivery"},"description":"Price, delivery promise and total before tax for one product_id, ZIP, quantity and mode (local_delivery or ship_to_home). Call it when the shopper picks a product, before quoting a total.","inputSchema":{"type":"object","additionalProperties":false,"required":["product_id","zip","quantity","fulfillment_mode"],"properties":{"product_id":{"type":"string","pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$","maxLength":128},"zip":{"type":"string","pattern":"^[0-9]{5}$"},"quantity":{"type":"integer","minimum":1,"maximum":10000},"fulfillment_mode":{"type":"string","enum":["local_delivery","ship_to_home"]}}},"outputSchema":{"type":"object","properties":{"product_id":{"type":"string"},"title":{"type":"string"},"fulfillment_mode":{"type":"string","enum":["local_delivery","ship_to_home"]},"available":{"type":"boolean","description":"True when this mode can be ordered for this product, ZIP and quantity."},"delivery_promise":{"type":"string","description":"Local delivery: \"Get it today\" or \"We'll deliver by <Month D>\". Ship-to-home: \"Ships to you\"."},"pricing":{"type":"object","description":"unit_price x quantity + fee = total_before_tax. Sales tax is added at checkout.","properties":{"quantity":{"type":"integer"},"unit_price":{"type":"string"},"subtotal":{"type":"string","description":"unit_price x quantity, when quantity > 1."},"fee":{"type":"string","description":"Local delivery fee or flat shipping."},"total_before_tax":{"type":"string"},"eta":{"type":"object","properties":{"earliest_date":{"type":"string"},"latest_date":{"type":"string"}}},"reason_code":{"type":"string","enum":["no_price","no_live_offer","out_of_stock","not_served_locally","variant_required","product_not_found","invalid_input","fee_unavailable","price_unavailable","catalog_unavailable","rate_limited","not_checked","no_buyable_offer"],"description":"Machine-readable reason, alongside the prose note."},"note":{"type":"string"}}},"unit_price":{"type":"string"},"reason_code":{"type":"string","enum":["no_price","no_live_offer","out_of_stock","not_served_locally","variant_required","product_not_found","invalid_input","fee_unavailable","price_unavailable","catalog_unavailable","rate_limited","not_checked","no_buyable_offer"],"description":"Why this mode cannot be bought here now."},"note":{"type":"string"}},"required":["product_id","fulfillment_mode","available"]}},{"name":"get_order_status","title":"Check an order","annotations":{"title":"Check an order","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"description":"Read where a JENNi order stands: status, delivery ETA when known, courier tracking and whether the card was charged. Requires the private order_token from the shopper’s JENNi order page (starts jos1_). Read-only; it shows no personal details.","inputSchema":{"type":"object","additionalProperties":false,"required":["order_token"],"properties":{"order_token":{"type":"string","maxLength":512,"description":"The order token from the shopper's JENNi order page, starting jos1_."}}},"outputSchema":{"type":"object","required":["status","order_state","eta","items","tracking","payment","refund_state","next_step"],"properties":{"status":{"type":"string","enum":["placed","processing","out_for_delivery","delivered","needs_attention","cancelled","unknown"]},"order_state":{"type":["string","null"]},"updated_at":{"type":["string","null"]},"eta":{"type":["string","null"],"description":"Delivery estimate when JENNi has one; null means not known yet."},"items":{"type":"array","items":{"type":"object","properties":{"name":{"type":["string","null"]},"quantity":{"type":"integer"}}}},"tracking":{"type":"array","items":{"type":"object","properties":{"status":{"type":["string","null"]},"carrier":{"type":["string","null"]},"tracking_number":{"type":["string","null"]},"tracking_url":{"type":["string","null"]},"updated_at":{"type":["string","null"]}}}},"payment":{"type":"object","properties":{"state":{"type":"string","enum":["pending","charged","not_charged","none","unavailable"]},"pending_amount_cents":{"type":["integer","null"]}}},"refund_state":{"type":"string","enum":["none","not_charged","unknown"]},"next_step":{"type":"string"}}}},{"name":"create_checkout","title":"Start an order","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"title":"Start an order"},"description":"Start an order JENNi will deliver, without leaving the chat. Give the exact product_id, the delivery address and the shopper's contact details. Returns the delivery options and the order total. Nothing is charged until complete_checkout. Delivered by JENNi.","inputSchema":{"type":"object","additionalProperties":false,"required":["product_id","delivery_address","buyer"],"properties":{"product_id":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,128}$","maxLength":128},"quantity":{"type":"integer","minimum":1,"maximum":10000,"description":"How many (default 1)."},"delivery_address":{"type":"object","additionalProperties":false,"required":["street_address","city","state","postal_code"],"properties":{"first_name":{"type":"string","maxLength":100},"last_name":{"type":"string","maxLength":100},"street_address":{"type":"string","maxLength":200},"extended_address":{"type":"string","maxLength":200},"city":{"type":"string","maxLength":100},"state":{"type":"string","minLength":2,"maxLength":2,"description":"2-letter US state."},"postal_code":{"type":"string","pattern":"^[0-9]{5}(-[0-9]{4})?$"},"country":{"type":"string","enum":["US"]}}},"buyer":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"string","maxLength":254},"phone_number":{"type":"string","maxLength":32},"first_name":{"type":"string","maxLength":100},"last_name":{"type":"string","maxLength":100}},"required":["email","phone_number","first_name","last_name"]},"idempotency_key":{"type":"string","minLength":8,"maxLength":80,"description":"Optional. Reuse the same value to retry safely; the retry returns the first result instead of acting twice."}}},"outputSchema":{"type":"object","required":["checkout_id","status","fulfilled_by","totals","fulfillment_options","messages","next_step"],"properties":{"checkout_id":{"type":["string","null"]},"status":{"type":"string","description":"incomplete, ready_for_complete, requires_escalation, completed or canceled."},"currency":{"type":"string"},"fulfilled_by":{"type":"string","const":"Delivered by JENNi"},"line_items":{"type":"array"},"totals":{"type":"object"},"fulfillment_options":{"type":"array"},"selected_fulfillment_mode":{"type":["string","null"]},"messages":{"type":"array"},"expires_at":{"type":["string","null"]},"order_id":{"type":["string","null"]},"continue_url":{"type":"string","description":"Present when the shopper should finish on JENNi instead."},"reason_code":{"type":"string"},"next_step":{"type":"string"}}}},{"name":"update_checkout","title":"Update an order","annotations":{"readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false,"title":"Update an order"},"description":"Choose local_delivery or ship_to_home, or change the quantity, address or contact details of an order started with create_checkout. Call with only checkout_id to re-read it. Returns the order total once a delivery option is chosen.","inputSchema":{"type":"object","additionalProperties":false,"required":["checkout_id"],"properties":{"checkout_id":{"type":"string","pattern":"^chk_[A-Za-z0-9]{8,64}$"},"fulfillment_mode":{"type":"string","enum":["local_delivery","ship_to_home"]},"quantity":{"type":"integer","minimum":1,"maximum":10000},"delivery_address":{"type":"object","additionalProperties":false,"required":["street_address","city","state","postal_code"],"properties":{"first_name":{"type":"string","maxLength":100},"last_name":{"type":"string","maxLength":100},"street_address":{"type":"string","maxLength":200},"extended_address":{"type":"string","maxLength":200},"city":{"type":"string","maxLength":100},"state":{"type":"string","minLength":2,"maxLength":2,"description":"2-letter US state."},"postal_code":{"type":"string","pattern":"^[0-9]{5}(-[0-9]{4})?$"},"country":{"type":"string","enum":["US"]}}},"buyer":{"type":"object","additionalProperties":false,"properties":{"email":{"type":"string","maxLength":254},"phone_number":{"type":"string","maxLength":32},"first_name":{"type":"string","maxLength":100},"last_name":{"type":"string","maxLength":100}}},"idempotency_key":{"type":"string","minLength":8,"maxLength":80,"description":"Optional. Reuse the same value to retry safely; the retry returns the first result instead of acting twice."}}},"outputSchema":{"type":"object","required":["checkout_id","status","fulfilled_by","totals","fulfillment_options","messages","next_step"],"properties":{"checkout_id":{"type":["string","null"]},"status":{"type":"string","description":"incomplete, ready_for_complete, requires_escalation, completed or canceled."},"currency":{"type":"string"},"fulfilled_by":{"type":"string","const":"Delivered by JENNi"},"line_items":{"type":"array"},"totals":{"type":"object"},"fulfillment_options":{"type":"array"},"selected_fulfillment_mode":{"type":["string","null"]},"messages":{"type":"array"},"expires_at":{"type":["string","null"]},"order_id":{"type":["string","null"]},"continue_url":{"type":"string","description":"Present when the shopper should finish on JENNi instead."},"reason_code":{"type":"string"},"next_step":{"type":"string"}}}},{"name":"complete_checkout","title":"Place the order","annotations":{"readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false,"title":"Place the order"},"description":"Place the order. Only after the shopper has approved the total from update_checkout. Pays with the shopper's Stripe shared payment token (spt_...), issued for at least the order total. Never send card numbers. Delivered by JENNi.","inputSchema":{"type":"object","additionalProperties":false,"required":["checkout_id","payment_token"],"properties":{"checkout_id":{"type":"string","pattern":"^chk_[A-Za-z0-9]{8,64}$"},"payment_token":{"type":"string","pattern":"^spt_[A-Za-z0-9_]{1,250}$","maxLength":254,"description":"Stripe shared payment token, starting spt_."},"idempotency_key":{"type":"string","minLength":8,"maxLength":80,"description":"Optional. Reuse the same value to retry safely; the retry returns the first result instead of acting twice."}}},"outputSchema":{"type":"object","required":["checkout_id","status","fulfilled_by","totals","fulfillment_options","messages","next_step"],"properties":{"checkout_id":{"type":["string","null"]},"status":{"type":"string","description":"incomplete, ready_for_complete, requires_escalation, completed or canceled."},"currency":{"type":"string"},"fulfilled_by":{"type":"string","const":"Delivered by JENNi"},"line_items":{"type":"array"},"totals":{"type":"object"},"fulfillment_options":{"type":"array"},"selected_fulfillment_mode":{"type":["string","null"]},"messages":{"type":"array"},"expires_at":{"type":["string","null"]},"order_id":{"type":["string","null"]},"continue_url":{"type":"string","description":"Present when the shopper should finish on JENNi instead."},"reason_code":{"type":"string"},"next_step":{"type":"string"}}}}],"links":{"mcp":"https://shop.jennipro.com/mcp","ucp":"https://shop.jennipro.com/.well-known/ucp","acp":"https://shop.jennipro.com/.well-known/acp","trusted_agent":"https://shop.jennipro.com/.well-known/trusted-agent","openapi_json":"https://shop.jennipro.com/openapi.json","openapi_yaml":"https://shop.jennipro.com/openapi.yaml","ai_plugin":"https://shop.jennipro.com/.well-known/ai-plugin.json","agents_md":"https://shop.jennipro.com/agents.md","llms_txt":"https://shop.jennipro.com/llms.txt"}}