{"record":{"id":"5403d30b0513cb7a","repo":"googleapis/mcp-toolbox","slug":"toolset-s-not-found-in-prebuilt-configuration","errorCode":null,"errorMessage":"toolset '%s' not found in prebuilt configuration '%s'. Available toolsets: %s","messagePattern":"toolset '(.+?)' not found in prebuilt configuration '(.+?)'\\. Available toolsets: (.+?)","errorType":"console","errorClass":null,"httpStatus":null,"severity":"error","filePath":"cmd/internal/options.go","lineNumber":243,"sourceCode":"\t\t\t\terrMsg := fmt.Errorf(\"unable to parse prebuilt tool configuration for '%s': %w\", configName, err)\n\t\t\t\tlogger.ErrorContext(ctx, errMsg.Error())\n\t\t\t\treturn isCustomConfigured, errMsg\n\t\t\t}\n\n\t\t\tif toolsetName != \"\" {\n\t\t\t\t// Legacy toolsets are folded into groups at unmarshal, so the named\n\t\t\t\t// toolset resolves as a group.\n\t\t\t\ttargetGroup, exists := parsed.Groups[toolsetName]\n\t\t\t\tif !exists {\n\t\t\t\t\tvar available []string\n\t\t\t\t\tfor k := range parsed.Groups {\n\t\t\t\t\t\tif k == \"\" {\n\t\t\t\t\t\t\tcontinue\n\t\t\t\t\t\t}\n\t\t\t\t\t\tavailable = append(available, k)\n\t\t\t\t\t}\n\t\t\t\t\tslices.Sort(available)\n\t\t\t\t\terrMsg := fmt.Errorf(\"toolset '%s' not found in prebuilt configuration '%s'. Available toolsets: %s\", toolsetName, sourceName, strings.Join(available, \", \"))\n\t\t\t\t\tlogger.ErrorContext(ctx, errMsg.Error())\n\t\t\t\t\treturn isCustomConfigured, errMsg\n\t\t\t\t}\n\n\t\t\t\t// Filter tools to only include those in the target group\n\t\t\t\tfilteredTools := make(server.ToolConfigs)\n\t\t\t\tfor _, tName := range targetGroup.ToolNames {\n\t\t\t\t\tif tCfg, tExists := parsed.Tools[tName]; tExists {\n\t\t\t\t\t\tfilteredTools[tName] = tCfg\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\tparsed.Tools = filteredTools\n\n\t\t\t\t// Filter groups to only include the target group\n\t\t\t\tfilteredGroups := make(server.GroupConfigs)\n\t\t\t\tfilteredGroups[toolsetName] = targetGroup\n\t\t\t\tparsed.Groups = filteredGroups\n\t\t\t}","sourceCodeStart":225,"sourceCodeEnd":261,"githubUrl":"https://github.com/googleapis/mcp-toolbox/blob/8cc6e09de2ad7b8bffc77751799585a1401a48eb/cmd/internal/options.go#L225-L261","documentation":"Prebuilt configs are organized as '<source>/<toolset>'. After parsing, LoadConfig looks up the requested toolset in the config's tool groups; if absent, it lists all available toolsets so you can pick a valid one.","triggerScenarios":"Requesting a toolset name that does not exist in the parsed prebuilt config's groups (case mismatch, old toolset name removed, or inventing a name).","commonSituations":"Using 'postgres/postgres' instead of 'postgres/postgres-sql', or referencing a toolset renamed across toolbox versions.","solutions":["Use one of the toolsets listed in 'Available toolsets' in the error message","Check the toolset spelling and case against the source's docs (e.g. postgres/postgres-sql)","Upgrade the toolbox binary if the toolset was added in a newer release"],"exampleFix":"// before\n--prebuilt postgres/postgres\n// after\n--prebuilt postgres/postgres-sql","handlingStrategy":"validation","validationCode":"// confirm the toolset exists before invoking\ncurl -sf http://127.0.0.1:5000/api/toolset | jq 'keys'  # lists available toolsets on a running instance","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Check the error's 'Available toolsets' list for exact valid names","Use documented toolset names like '<source>/postgres-sql', not ad-hoc names","Pin toolbox versions in scripts so toolset names don't drift"],"tags":["cli","configuration","prebuilt-configs","toolset"],"backgroundTag":"toolset-not-found","analyzedSha":"8cc6e09de2ad7b8bffc77751799585a1401a48eb","analyzedAt":"2026-09-05T01:10:36.887Z","contentChangedAt":"2026-09-05T01:10:36.887Z","schemaVersion":2},"datasetVersion":"2026-09-08T10:18:20.063Z"}