MCP Instruct

Instructions

Implementation Reference

• src/index.ts:363-377 (registration)

  Registers the 'agent_switch_quick' tool including its input schema for quick agent switching using shorthand names.

  {
    name: 'agent_switch_quick',
    description: 'Quick switch agent using shorthand (it/hacker/sales/blue/red/purple)',
    inputSchema: {
      type: 'object',
      properties: {
        type: {
          type: 'string',
          enum: ['it', 'hacker', 'sales', 'blue', 'red', 'purple'],
          description: 'Quick switch type'
        }
      },
      required: ['type']
    }
  },

• src/index.ts:920-938 (handler)

  Tool handler that initializes AgentManager, performs quick switch via am.quickSwitch(type), validates success, and returns confirmation with active agent name.

  case 'agent_switch_quick': {
    await am.initialize();
    const { type } = args as any;
    const success = am.quickSwitch(type);
    
    if (!success) {
      throw new Error(`Invalid agent type: ${type}`);
    }
    
    const activeAgent = am.getActiveAgent();
    return {
      content: [
        {
          type: 'text',
          text: `✅ Switched to ${activeAgent?.name}`
        }
      ]
    };
  }

• src/AgentManager.ts:168-182 (helper)

  Core logic of agent_switch_quick: maps shorthand types to full agent IDs and delegates to setActiveAgent, returning success boolean.

  quickSwitch(type: 'it' | 'hacker' | 'sales' | 'blue' | 'red' | 'purple'): boolean {
    const mapping: Record<string, string> = {
      'it': 'it-expert',
      'hacker': 'ethical-hacker',
      'sales': 'sales-expert',
      'blue': 'blue-team',
      'red': 'red-team',
      'purple': 'purple-team'
    };
  
    const id = mapping[type];
    if (id) {
      return this.setActiveAgent(id);
    }
    return false;