add-to-cart
Add products to your shopping cart by specifying product variant ID and quantity for purchase through Terminal.shop's API.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| productVariantID | Yes | ||
| quantity | Yes |
Implementation Reference
- server.js:570-615 (handler)Handler function that adds the specified product variant and quantity to the shopping cart via the Terminal.shop API, then returns updated cart summary.
async ({ productVariantID, quantity }) => { try { const response = await terminalApi.put("/cart/item", { productVariantID, quantity, }); const cart = response.data.data; let formattedText = "# Item Added to Cart\n\n"; formattedText += `Successfully added item to your cart.\n\n`; formattedText += "## Updated Cart\n"; formattedText += `Items: ${cart.items.length}\n`; formattedText += `Subtotal: $${cart.subtotal / 100}\n`; if (cart.amount && cart.amount.shipping) { formattedText += `Shipping: $${cart.amount.shipping / 100}\n`; if (cart.amount.total) { formattedText += `Total: $${cart.amount.total / 100}\n`; } else { formattedText += `Total: $${(cart.amount.subtotal + cart.amount.shipping) / 100}\n`; } } return { content: [ { type: "text", text: formattedText, }, ], }; } catch (error) { console.error("Error adding item to cart:", error); return { content: [ { type: "text", text: `Error adding item to cart: ${error.message}`, }, ], isError: true, }; } }, - server.js:566-569 (schema)Zod input schema defining required parameters: productVariantID (string) and quantity (positive integer).
{ productVariantID: z.string(), quantity: z.number().int().positive(), }, - server.js:564-616 (registration)MCP server.tool registration that defines the 'add-to-cart' tool including its schema and handler.
server.tool( "add-to-cart", { productVariantID: z.string(), quantity: z.number().int().positive(), }, async ({ productVariantID, quantity }) => { try { const response = await terminalApi.put("/cart/item", { productVariantID, quantity, }); const cart = response.data.data; let formattedText = "# Item Added to Cart\n\n"; formattedText += `Successfully added item to your cart.\n\n`; formattedText += "## Updated Cart\n"; formattedText += `Items: ${cart.items.length}\n`; formattedText += `Subtotal: $${cart.subtotal / 100}\n`; if (cart.amount && cart.amount.shipping) { formattedText += `Shipping: $${cart.amount.shipping / 100}\n`; if (cart.amount.total) { formattedText += `Total: $${cart.amount.total / 100}\n`; } else { formattedText += `Total: $${(cart.amount.subtotal + cart.amount.shipping) / 100}\n`; } } return { content: [ { type: "text", text: formattedText, }, ], }; } catch (error) { console.error("Error adding item to cart:", error); return { content: [ { type: "text", text: `Error adding item to cart: ${error.message}`, }, ], isError: true, }; } }, );