@snowcone-app/mcp 0.9.0 → 0.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +6 -0
- package/README.md +1 -1
- package/dist/index.js +5 -5
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,11 @@
|
|
|
1
1
|
# @snowcone-app/mcp
|
|
2
2
|
|
|
3
|
+
## 0.9.1
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- [#4283](https://github.com/snowcone-app/snowcone-monorepo/pull/4283) [`4fbaaf1`](https://github.com/snowcone-app/snowcone-monorepo/commit/4fbaaf161d0c580a1c56790a9a4c54f676a92abc) Thanks [@kevinsproles](https://github.com/kevinsproles)! - Examples and tool descriptions use live demo products: the iPhone 17 Pro Max Case (`BC43BE`), the Canvas Tote (`CAXHQC`) and the All-Over Print Zip Hoodie (`XTNA6J`), in place of the Framed Canvas (`BEEB77`) and Women's Tee (`KMYKUK`), which are no longer for sale. No API change.
|
|
8
|
+
|
|
3
9
|
## 0.9.0
|
|
4
10
|
|
|
5
11
|
### Minor Changes
|
package/README.md
CHANGED
|
@@ -57,7 +57,7 @@ URL builder is bundled in).
|
|
|
57
57
|
## The happy path
|
|
58
58
|
|
|
59
59
|
1. `snowcone_mint_shop` once → get a `shop_id` (reuse it everywhere).
|
|
60
|
-
2. `snowcone_get_product` to pick a product code (`
|
|
60
|
+
2. `snowcone_get_product` to pick a product code (`BC43BE` is a good demo).
|
|
61
61
|
3. `snowcone_render_mockup` with the code, your `shop_id`, and a **publicly
|
|
62
62
|
fetchable** image URL → an image URL you can drop anywhere.
|
|
63
63
|
4. `snowcone_buy_url` to sell it; hand `claim.verification_uri_complete` to your
|
package/dist/index.js
CHANGED
|
@@ -335,7 +335,7 @@ image URL. There is nothing to install to render or sell.
|
|
|
335
335
|
|
|
336
336
|
2. **Find a product** \u2014 \`snowcone_search_catalog\` to browse, or
|
|
337
337
|
\`snowcone_get_product\` for placements/mockups/options. Every tool takes the
|
|
338
|
-
code as \`product\` (e.g. \`{ product: "
|
|
338
|
+
code as \`product\` (e.g. \`{ product: "BC43BE" }\`). \`BC43BE\` is a known
|
|
339
339
|
good demo product code.
|
|
340
340
|
|
|
341
341
|
3. **Render a mockup** \u2014 \`snowcone_render_mockup\` with the product code, your
|
|
@@ -682,7 +682,7 @@ var fillSchema = z.union([
|
|
|
682
682
|
z.object({ color: z.string().describe("Solid color hex, e.g. '#ff0000'.") })
|
|
683
683
|
]);
|
|
684
684
|
var urlShape = {
|
|
685
|
-
product: z.string().min(1).describe("Product code (the catalog document id), e.g. '
|
|
685
|
+
product: z.string().min(1).describe("Product code (the catalog document id), e.g. 'BC43BE'."),
|
|
686
686
|
shop: z.string().min(1).describe("Your public Shop ID from snowcone_mint_shop."),
|
|
687
687
|
asset: z.string().optional().describe(
|
|
688
688
|
"A single publicly-fetchable image URL. This is the BASE design \u2014 it is painted on EVERY placement of the product by default (front, back, sleeves, \u2026), so one image covers the whole product with no extra work. Add 'design' to override specific placements; omit it for the same image everywhere."
|
|
@@ -954,7 +954,7 @@ server.registerTool(
|
|
|
954
954
|
// spelled it `id_or_slug` cost every cold agent a guaranteed failed
|
|
955
955
|
// round-trip. `product` is the canonical name; `id_or_slug` stays as a
|
|
956
956
|
// silent alias so agents that learned the old name keep working.
|
|
957
|
-
product: z.string().min(1).optional().describe("Product code (the catalog document id) or slug, e.g. '
|
|
957
|
+
product: z.string().min(1).optional().describe("Product code (the catalog document id) or slug, e.g. 'BC43BE'. Same name as every other tool."),
|
|
958
958
|
id_or_slug: z.string().min(1).optional().describe("Deprecated alias of 'product' \u2014 accepted for back-compat; prefer 'product'.")
|
|
959
959
|
},
|
|
960
960
|
annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true }
|
|
@@ -964,7 +964,7 @@ server.registerTool(
|
|
|
964
964
|
const code = args.product ?? args.id_or_slug;
|
|
965
965
|
if (!code) {
|
|
966
966
|
return fail(
|
|
967
|
-
"E_MISSING_PRODUCT: pass product (the product code or slug, e.g. { product: '
|
|
967
|
+
"E_MISSING_PRODUCT: pass product (the product code or slug, e.g. { product: 'BC43BE' }) \u2014 the same 'product' argument snowcone_render_mockup and snowcone_buy_url take."
|
|
968
968
|
);
|
|
969
969
|
}
|
|
970
970
|
const p = await getProduct(code);
|
|
@@ -1081,7 +1081,7 @@ server.registerTool(
|
|
|
1081
1081
|
title: "Get the price, shipping and delivery",
|
|
1082
1082
|
description: "Tell the user what a printed product costs and when it would arrive, before they buy. Returns the price the buy link will charge (before tax), and each shipping option with its cost and delivery estimate for where it's going. Takes the same product and options as snowcone_buy_url; no artwork or shop needed. Nothing is created or charged. Only promise what comes back: an option with no estimated_delivery means we have no date for it yet.",
|
|
1083
1083
|
inputSchema: {
|
|
1084
|
-
product: z.string().min(1).describe("Product code (the catalog document id), e.g. '
|
|
1084
|
+
product: z.string().min(1).describe("Product code (the catalog document id), e.g. 'BC43BE'."),
|
|
1085
1085
|
options: z.record(z.string()).optional().describe("Variant option picks: attribute \u2192 choice, e.g. { size: 'M', color: 'black' }. The price depends on these."),
|
|
1086
1086
|
quantity: z.number().int().min(1).max(100).optional().describe("How many (1 to 100). Default 1."),
|
|
1087
1087
|
ship_to: z.string().length(2).optional().describe("2-letter destination country, e.g. 'US'. Default US. A country we can't ship to returns an error listing the ones we can.")
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@snowcone-app/mcp",
|
|
3
|
-
"version": "0.9.
|
|
3
|
+
"version": "0.9.1",
|
|
4
4
|
"mcpName": "io.github.snowcone-app/snowcone",
|
|
5
5
|
"description": "Snowcone MCP server — the agent-native quickstart. Mint a sandbox shop, browse the catalog, and turn any image into a buyable printed-merch mockup URL, all as callable tools.",
|
|
6
6
|
"keywords": [
|