Terminal.shop MCP Server

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(),
  },