Orchestrator MCP

Instructions

Implementation Reference

• src/server/handlers/orchestrator.ts:97-129 (handler)

  The core handler function that executes the ai_status tool logic. It checks AI availability, tests capabilities, gathers configuration info, and returns a formatted status response.

  export async function handleAIStatus(aiOrchestrator: AIOrchestrator) {
    try {
      const isAvailable = aiOrchestrator.isAIAvailable();
      const capabilities = await aiOrchestrator.testAICapabilities();
  
      const status = {
        available: isAvailable,
        capabilities,
        apiKeyConfigured: !!process.env.OPENROUTER_API_KEY,
        model: process.env.OPENROUTER_DEFAULT_MODEL || 'anthropic/claude-3.5-sonnet',
        configurationNote: 'API keys should be configured in MCP client settings under "env" section',
      };
  
      return {
        content: [
          {
            type: 'text',
            text: `AI Orchestration Status:\n\n${JSON.stringify(status, null, 2)}`,
          },
        ],
      };
    } catch (error) {
      logger.error('Failed to get AI status:', error as Error);
      return {
        content: [
          {
            type: 'text',
            text: `Error getting AI status: ${error instanceof Error ? error.message : String(error)}`,
          },
        ],
      };
    }
  }

• src/server/handlers/tools.ts:48-57 (schema)

  Defines the tool name, description, and input schema (empty object) for ai_status, used in the ListTools response.

  {
    name: 'ai_status',
    description: 'Health monitoring - check AI orchestration system status, model configuration, and capability testing results. Useful for debugging or verifying system readiness.',
    inputSchema: {
      type: 'object',
      properties: {},
      additionalProperties: false,
      $schema: 'http://json-schema.org/draft-07/schema#',
    },
  },

• src/server/handlers/dispatcher.ts:43-45 (registration)

  Dispatches 'ai_status' tool calls to the handleAIStatus handler function.

  case 'ai_status':
    return handleAIStatus(aiOrchestrator);

• src/server/handlers/dispatcher.ts:13-17 (registration)

  Imports the handleAIStatus function for use in tool dispatching.

  import {
    handleGetInfo,
    handleAIProcess,
    handleAIStatus
  } from './orchestrator.js';