search-products
Find products in Terminal.shop by entering search queries to browse available items through the MCP server.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No |
Implementation Reference
- server.js:430-499 (registration)Registration of the 'search-products' tool using McpServer.tool() method, including inline schema and handler function.server.tool( "search-products", { query: z.string().optional(), }, async ({ query = "" }) => { try { const response = await terminalApi.get("/product"); const products = response.data.data; // Filter products if query is provided const filteredProducts = query ? products.filter( (p) => p.name.toLowerCase().includes(query.toLowerCase()) || p.description.toLowerCase().includes(query.toLowerCase()), ) : products; if (filteredProducts.length === 0) { return { content: [ { type: "text", text: `No products found matching "${query}".`, }, ], }; } // Format the response let formattedText = query ? `# Products matching "${query}"\n\n` : "# All Terminal.shop Products\n\n"; filteredProducts.forEach((product) => { formattedText += `## ${product.name}\n`; formattedText += `ID: ${product.id}\n`; formattedText += `${product.description}\n\n`; formattedText += "### Variants:\n"; product.variants.forEach((variant) => { formattedText += `- ${variant.name}: $${variant.price / 100} (ID: ${variant.id})\n`; }); formattedText += "\n"; }); return { content: [ { type: "text", text: formattedText, }, ], }; } catch (error) { console.error("Error searching products:", error); return { content: [ { type: "text", text: `Error searching products: ${error.message}`, }, ], isError: true, }; } }, );
- server.js:435-498 (handler)The handler function fetches all products from the Terminal.shop API, optionally filters them by the provided query in name or description, formats the matching products with their details and variants as markdown text, and returns it in the MCP content format. Handles errors gracefully.async ({ query = "" }) => { try { const response = await terminalApi.get("/product"); const products = response.data.data; // Filter products if query is provided const filteredProducts = query ? products.filter( (p) => p.name.toLowerCase().includes(query.toLowerCase()) || p.description.toLowerCase().includes(query.toLowerCase()), ) : products; if (filteredProducts.length === 0) { return { content: [ { type: "text", text: `No products found matching "${query}".`, }, ], }; } // Format the response let formattedText = query ? `# Products matching "${query}"\n\n` : "# All Terminal.shop Products\n\n"; filteredProducts.forEach((product) => { formattedText += `## ${product.name}\n`; formattedText += `ID: ${product.id}\n`; formattedText += `${product.description}\n\n`; formattedText += "### Variants:\n"; product.variants.forEach((variant) => { formattedText += `- ${variant.name}: $${variant.price / 100} (ID: ${variant.id})\n`; }); formattedText += "\n"; }); return { content: [ { type: "text", text: formattedText, }, ], }; } catch (error) { console.error("Error searching products:", error); return { content: [ { type: "text", text: `Error searching products: ${error.message}`, }, ], isError: true, }; } },
- server.js:432-434 (schema)Zod input schema defining an optional 'query' string parameter for filtering products.{ query: z.string().optional(), },