naftiko: 1.0.0-alpha2
info:
  label: Zestful Recipe Data Enrichment
  description: Workflow capability for enriching recipe data by parsing raw ingredient strings into structured, USDA-matched
    nutritional data. Used by recipe app developers to build searchable recipes, generate shopping lists, and create ingredient
    databases.
  tags:
  - Food
  - Ingredients
  - Parsers
  - Recipes
  - USDA
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    ZESTFUL_API_KEY: ZESTFUL_API_KEY
capability:
  consumes:
  - type: http
    namespace: zestful
    baseUri: https://zestfuldata.com
    description: Zestful ingredient parser API that extracts structured data from free-form recipe ingredient text.
    authentication:
      type: apikey
      key: X-Api-Key
      value: '{{ZESTFUL_API_KEY}}'
      placement: header
    resources:
    - name: ingredients
      path: /parseIngredients
      description: Parse raw ingredient strings into structured JSON
      operations:
      - name: parse-ingredients
        method: POST
        description: Parse a list of raw ingredient strings into structured data including quantity, unit, product name, preparation
          notes, and USDA nutritional database matches.
        outputRawFormat: json
        outputParameters:
        - name: results
          type: array
          value: $.results
        - name: requestsRemaining
          type: integer
          value: $.requestsRemaining
        body:
          type: json
          data:
            ingredients: '{{tools.ingredients}}'
  exposes:
  - type: rest
    port: 8080
    namespace: recipe-enrichment-api
    description: Unified REST API for recipe data enrichment and ingredient parsing.
    resources:
    - path: /v1/ingredients/parse
      name: ingredient-parser
      description: Parse raw recipe ingredient strings into structured data
      operations:
      - method: POST
        name: parse-ingredients
        description: Parse a list of raw recipe ingredient strings (up to 100 per request) into structured data with quantity,
          unit, product name, preparation notes, and USDA FoodData Central database matches.
        call: zestful.parse-ingredients
        with:
          ingredients: rest.ingredients
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: recipe-enrichment-mcp
    transport: http
    description: MCP server for AI-assisted recipe data enrichment and ingredient analysis.
    tools:
    - name: parse-recipe-ingredients
      description: Parse a list of raw recipe ingredient strings into structured JSON data. Extracts quantity, measurement
        unit, product name, preparation notes, and matches each ingredient against the USDA FoodData Central database. Supports
        up to 100 ingredients per request. Use for building searchable recipes, shopping list generation, and nutritional
        analysis.
      hints:
        readOnly: false
        openWorld: true
      call: zestful.parse-ingredients
      with:
        ingredients: tools.ingredients
      outputParameters:
      - type: object
        mapping: $.