googleapis/mcp-toolbox · error

no value specified for filter on field '%s'

Error message

no value specified for filter on field '%s'

What it means

Filter-validation guard in FilterConfig.Validate: the filter has a field and a valid operator but `value` is null/absent, so the comparison cannot be constructed.

Source

Thrown at internal/tools/firestore/firestorequerycollection/firestorequerycollection.go:221

	Value interface{} `json:"value"`
}

// Validate checks if the filter configuration is valid
func (f *FilterConfig) Validate() error {
	if f.Field == "" {
		return fmt.Errorf("filter field cannot be empty")
	}

	if !validOperators[f.Op] {
		ops := make([]string, 0, len(validOperators))
		for op := range validOperators {
			ops = append(ops, op)
		}
		return fmt.Errorf(errInvalidOperator, f.Op, ops)
	}

	if f.Value == nil {
		return fmt.Errorf(errMissingFilterValue, f.Field)
	}

	return nil
}

// OrderByConfig represents ordering configuration
type OrderByConfig struct {
	Field     string `json:"field"`
	Direction string `json:"direction"`
}

// GetDirection returns the Firestore direction constant
func (o *OrderByConfig) GetDirection() firestoreapi.Direction {
	if strings.EqualFold(o.Direction, "DESCENDING") {
		return firestoreapi.Desc
	}
	return firestoreapi.Asc
}

View on GitHub (pinned to 8cc6e09de2)

Solutions

  1. Supply a concrete `value` (including explicit nulls via the appropriate Firestore sentinel if intended)
  2. Remove filters you did not mean to send
Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at internal/tools/firestore/firestorequerycollection/firestorequerycollection.go:221 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of googleapis/mcp-toolbox@8cc6e09de2 (2026-09-05). Data as JSON: /api/errors/2a543c382334cbe8. Report an issue: GitHub.