ruvnet/ruflo · error

Tool validation warnings

Error message

Tool validation warnings

What it means

Startup warning in the MCP server entrypoint main(): validateToolRegistration() reported invalid=false, meaning the tool registry has issues (duplicates, missing handlers, schema problems). Startup continues and the issues are logged for diagnosis.

Source

Thrown at v3/mcp/server-entry.ts:196

}

/**
 * Main server initialization
 */
async function main(): Promise<void> {
  const options = parseArgs();
  const logger = createLogger(options.logLevel);

  logger.info('Starting Claude-Flow MCP Server V3', {
    transport: options.transport,
    host: options.host,
    port: options.port,
  });

  // Validate tools before starting
  const validation = validateToolRegistration();
  if (!validation.valid) {
    logger.warn('Tool validation warnings', {
      issues: validation.issues,
    });
  }

  // Get tool statistics
  const stats = getToolStats();
  logger.info('Tool registry initialized', {
    total: stats.total,
    categories: stats.categories,
    cacheable: stats.cacheable,
  });

  // Server configuration
  const config: Partial<MCPServerConfig> = {
    name: 'Claude-Flow MCP Server V3',
    version: '3.0.0',
    transport: options.transport,
    host: options.host,

View on GitHub (pinned to fa13ee4ad6)

Solutions

1. Inspect the validation warnings listed with this error and fix the flagged tool schemas (names, inputSchema, descriptions).
2. Ensure every registered tool conforms to the MCP tool schema requirements before server start.

When it happens

Trigger: Tool registration at server startup produces non-fatal schema validation warnings (e.g., missing descriptions, loose input schemas); server continues but logs the warnings for remediation.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/ruflo@fa13ee4ad6 (2026-08-18). Data as JSON: /api/errors/e76d03ca88990345. Report an issue: GitHub.