Method renderTableResult

backend/api/mcp/tool_schema.go:318–342

renderTableResult dispatches the `table=` drill-down path: it picks the unique match (or returns an appropriate error result) and renders it as TableDetail. schemaHint is the engine-adjusted schema filter (empty when dropped for single-schema engines) and is used for the candidate-lookup refetch too

(ctx context.Context, resolved *resolvedDatabase, input SchemaInput, schemaHint string, metadata *databaseMetadata, include string, warnings []string)

// schemaHint is the engine-adjusted schema filter (empty when dropped for
// single-schema engines) and is used for the candidate-lookup refetch too.
func (s *Server) renderTableResult(ctx context.Context, resolved *resolvedDatabase, input SchemaInput, schemaHint string, metadata *databaseMetadata, include string, warnings []string) (*mcp.CallToolResult, any) {
	matches := findTableMatches(metadata, input.Table)
	switch {
	case len(matches) == 0:
		// Re-fetch without table filter to surface candidates.
		candidates := s.lookupTableCandidates(ctx, resolved.resourceName, schemaHint, input.Table)
		return formatTableNotFound(input.Database, input.Table, candidates), nil
	case len(matches) > 1:
		// Same table name in multiple schemas. Don't silently pick one.
		schemas := make([]string, 0, len(matches))
		for _, m := range matches {
			schemas = append(schemas, m.schema)
		}
		return formatAmbiguousTable(input.Database, input.Table, schemas), nil
	}
	entry := buildTableEntry(matches[0].table, schemaIncludeDetails)
	output := &SchemaOutput{
		Database: resolved.resourceName,
		Engine:   resolved.engine,
		Table:    &entry,
	}
	return &mcp.CallToolResult{
		Content: []mcp.Content{&mcp.TextContent{Text: formatSchemaOutput(output, include, warnings)}},
	}, output
}

// renderSchemasResult handles the bulk schema listing path (no table drill-down).
func renderSchemasResult(resolved *resolvedDatabase, metadata *databaseMetadata, include string, warnings []string) (*mcp.CallToolResult, any) {