googleapis/mcp-toolbox · error

failed to process parameters: %v

Error message

failed to process parameters: %v

What it means

parameters.ProcessParameters failed while merging the tool's templateParameters and parameters in Initialize — the parameter definitions conflict or one is invalid (duplicate names, bad template, conflicting kinds).

Source

Thrown at internal/tools/cloudsqladmin/cloudsqladminsqlmany/cloudsqladminsqlmany.go:79

func (cfg Config) ToolConfigType() string {
	return resourceType
}

func (cfg Config) Initialize(context.Context) (tools.Tool, error) {
	if cfg.Description == "" {
		return nil, fmt.Errorf("description is required for tool %q", cfg.Name)
	}

	infraParams := parameters.Parameters{
		parameters.NewStringParameter("project", "The GCP project ID."),
		parameters.NewStringParameter("instanceId", "The Cloud SQL instance ID."),
		parameters.NewStringParameter("database", "The database name."),
	}

	allParams, _, err := parameters.ProcessParameters(cfg.TemplateParameters, cfg.Parameters)
	if err != nil {
		return nil, fmt.Errorf("failed to process parameters: %v", err)
	}

	finalParams := append(infraParams, allParams...)
	paramManifest := finalParams.Manifest()

	return Tool{
		BaseTool: tools.NewBaseTool(
			cfg,
			tools.GetAnnotationsOrDefault(cfg.Annotations, tools.NewDestructiveAnnotations),
			tools.Manifest{Description: cfg.Description, Parameters: paramManifest, AuthRequired: cfg.AuthRequired},
			finalParams,
		),
	}, nil
}

var _ tools.Tool = Tool{}

type Tool struct {

View on GitHub (pinned to 8cc6e09de2)

Solutions

1. Check for duplicate or conflicting parameter names in templateParameters vs parameters
2. Validate each parameter's kind and options
3. Fix the reported parameter definition in tools.yaml

When it happens

Trigger: Thrown at internal/tools/cloudsqladmin/cloudsqladminsqlmany/cloudsqladminsqlmany.go:79 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/e8bcc1a80f37c538. Report an issue: GitHub.