@crossly/mcp 0.1.0 → 0.2.0

package/dist/api.js

@@ -45,7 +45,7 @@ function getClient() {
     _client = createClient({
         pat: PAT,
         baseUrl: BASE_URL,
-        userAgent: '@crossly/mcp/0.1.0',
+        userAgent: '@crossly/mcp/0.2.0',
     });
     return _client;
 }

package/dist/index.js

@@ -29,7 +29,7 @@ async function main() {
     requirePat();
     const server = new Server({
         name: '@crossly/mcp',
-        version: '0.1.0',
+        version: '0.2.0',
     }, {
         capabilities: {
             tools: {},

package/dist/tools/orders/actions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/tools/orders/actions.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,OAAO,EAAE,MAAM,aAAa,CAAC;AAExD,8FAA8F;AAC9F,eAAO,MAAM,YAAY,EAAE,OAAO,EAyIjC,CAAC"}
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/tools/orders/actions.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,OAAO,EAAE,MAAM,aAAa,CAAC;AAExD,8FAA8F;AAC9F,eAAO,MAAM,YAAY,EAAE,OAAO,EA0KjC,CAAC"}

package/dist/tools/orders/actions.js

@@ -122,5 +122,33 @@ export const orderActions = [
             return apiPost(`/v1/orders/${encodeURIComponent(id)}/refund`, body, idempotencyKey);
         },
     },
+    {
+        name: 'order_link_listing',
+        description: "Link an UNMATCHED sale to one of the seller's listings. An unmatched sale is an order whose listing is an " +
+            "auto-created external-sale stub (the listing's platform row carries unmatchedSale) — the marketplace sold an " +
+            "id Crossly did not hold, e.g. a Whatnot show selling a copy of the seller's listing. This re-points the sale + " +
+            'order to the chosen listing, marks it sold quantity-aware (stock moves like a detected sale), archives the ' +
+            'stub, and DELISTS the item from every other marketplace once no unit is left. Confirm the listing with the ' +
+            'user first: it is the seller saying "this sale was that item". 409 when the order is already linked.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Crossly order UUID (from list_orders), not the marketplace order id.' },
+                listingId: { type: 'string', description: "Crossly listing UUID of the seller's real listing that sold." },
+                platformListingId: {
+                    type: 'string',
+                    description: "Optional: which of that listing's platform rows (its UUID) on the order's marketplace takes the sale, " +
+                        'when it has several. Omitted: the most recent one; when it has none the stub row moves under it.',
+                },
+                ...IDEMPOTENCY_PROP,
+            },
+            required: ['id', 'listingId'],
+            additionalProperties: false,
+        },
+        handler: (args) => {
+            const { id, idempotencyKey, ...body } = args;
+            return apiPost(`/v1/orders/${encodeURIComponent(id)}/link-listing`, body, idempotencyKey);
+        },
+    },
 ];
 //# sourceMappingURL=actions.js.map

package/dist/tools/orders/actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../src/tools/orders/actions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"actions.js","sourceRoot":"","sources":["../../../src/tools/orders/actions.ts"],"names":[],"mappings":"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"}

package/dist/tools/taxonomy.js

@@ -51,7 +51,7 @@ export const taxonomyTools = [
     {
         name: 'get_platform_category_aspects',
         description: 'Item-specific aspects (eBay) / properties (Etsy) / hard-coded enums (cookie platforms) for a category. Each ' +
-            'aspect carries: name, required, dataType, hasEnumValues, enumValues (when constrained), cardinality. The ' +
+            'aspect carries: name, required, dataType, selectionOnly, enumValues (when constrained), cardinality. The ' +
             'required ones MUST be filled in the listing body for the platform to accept it.',
         inputSchema: {
             type: 'object',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossly/mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Self-hostable Model Context Protocol server for Crossly. Exposes the Crossly public API (15 marketplaces, 57 endpoints) as MCP tools so an AI agent (Claude Desktop, Cursor, Cline) can run a reseller's multi-marketplace store end-to-end.",
   "type": "module",
   "main": "./dist/index.js",
@@ -37,7 +37,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^4.4.3",
-    "@crossly/sdk": "0.1.0"
+    "@crossly/sdk": "0.2.0"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",