`search_products`

Pack: nutrition · Endpoint: https://gateway.pipeworx.io/nutrition/mcp

Search for food products by name, brand, or keyword. Returns product name, brand, Nutri-Score, calories, protein, fat, and carbs.

Parameters

Name	Type	Required	Description
`query`	string	yes	Search query (product name, brand, or ingredient)
`limit`	number	no	Number of results to return (1-20, default 5)

Example call

Arguments

{
  "query": "whole wheat bread"
}

curl

curl -X POST https://gateway.pipeworx.io/nutrition/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"whole wheat bread"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search_products', {
  "query": "whole wheat bread"
});

More examples

{
  "query": "organic almond butter",
  "limit": 10
}

Response shape

Always returns: total_found, products

Field	Type	Description
`total_found`	number	Total number of products matching the search query
`products`	array	List of matching food products

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total_found": {
      "type": "number",
      "description": "Total number of products matching the search query"
    },
    "products": {
      "type": "array",
      "description": "List of matching food products",
      "items": {
        "type": "object",
        "properties": {
          "barcode": {
            "type": [
              "string",
              "null"
            ],
            "description": "Product barcode (EAN-13 or UPC)"
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Product name"
          },
          "brand": {
            "type": [
              "string",
              "null"
            ],
            "description": "Brand name"
          },
          "quantity": {
            "type": [
              "string",
              "null"
            ],
            "description": "Package quantity/size"
          },
          "nutriscore": {
            "type": [
              "string",
              "null"
            ],
            "description": "Nutri-Score grade (A-E)"
          },
          "nova_group": {
            "type": [
              "number",
              "null"
            ],
            "description": "NOVA processing group (1-4)"
          },
          "image_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Product image URL"
          },
          "nutrition": {
            "type": [
              "object",
              "null"
            ],
            "description": "Nutrition facts per 100g",
            "properties": {
              "calories_per_100g": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Energy in kilocalories per 100g"
              },
              "fat_g": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Total fat in grams per 100g"
              },
              "saturated_fat_g": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Saturated fat in grams per 100g"
              },
              "carbohydrates_g": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Carbohydrates in grams per 100g"
              },
              "sugars_g": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Sugars in grams per 100g"
              },
              "fiber_g": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Dietary fiber in grams per 100g"
              },
              "protein_g": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Protein in grams per 100g"
              },
              "salt_g": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Salt in grams per 100g"
              },
              "sodium_g": {
                "type": [
                  "number",
                  "null"
                ],
                "description": "Sodium in grams per 100g"
              }
            }
          }
        }
      }
    }
  },
  "required": [
    "total_found",
    "products"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "nutrition": {
      "url": "https://gateway.pipeworx.io/nutrition/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search_products