MCP Instruct

Instructions

Implementation Reference

• src/index.ts:1003-1090 (handler)

  Main handler for the mcp_instruct_onboarding tool within the MCP server's CallToolRequestSchema. Handles actions: 'start' (welcome message or return status), 'check_status' (JSON status), 'quick_setup' (updates personal/professional profile and sets active agent based on role).
  case 'mcp_instruct_onboarding': { await am.initialize(); const { action = 'start', data } = args as any; switch (action) { case 'start': const isNew = km.isNew(); if (isNew) { return { content: [ { type: 'text', text: `🎉 Welcome to MCP Instruct!\n\nI'll help you set up your personal knowledge base and AI agent.\n\nTell me:\n1. Your name\n2. Your role/occupation\n3. Preferred agent mode (IT, Security, Sales, etc.)\n\nOr use quick setup: mcp_instruct_onboarding with action="quick_setup"` } ] }; } else { const kb = km.getKnowledgeBase(); const activeAgent = am.getActiveAgent(); return { content: [ { type: 'text', text: `Welcome back, ${kb.personal.name || 'User'}!\n\nProfile: ${kb.professional.occupation || 'Not set'}\nActive Agent: ${activeAgent?.name || 'None'}\n\nYou can switch agents or update your profile anytime.` } ] }; } case 'check_status': const kb = km.getKnowledgeBase(); const agent = am.getActiveAgent(); return { content: [ { type: 'text', text: JSON.stringify({ isNew: km.isNew(), profile: { name: kb.personal.name, role: kb.professional.occupation }, activeAgent: agent?.name }, null, 2) } ] }; case 'quick_setup': if (data?.name) { await km.updatePersonal({ name: data.name }); } if (data?.role) { await km.updateProfessional({ occupation: data.role }); // Auto-select agent based on role if (data.role.toLowerCase().includes('it')) { am.setActiveAgent('it-expert'); } else if (data.role.toLowerCase().includes('security')) { am.setActiveAgent('ethical-hacker'); } else if (data.role.toLowerCase().includes('sales')) { am.setActiveAgent('sales-expert'); } } if (data?.preferredAgent) { am.setActiveAgent(data.preferredAgent); } return { content: [ { type: 'text', text: `✅ Setup complete!\n\nProfile: ${data?.name} - ${data?.role}\nActive Agent: ${am.getActiveAgent()?.name || 'None'}\n\nYour profile is saved and will persist across sessions.` } ] }; default: return { content: [ { type: 'text', text: 'Unknown onboarding action' } ] }; } }
• src/index.ts:396-419 (registration)

  Tool registration in the tools array, including name, description, and inputSchema for validation.
  { name: 'mcp_instruct_onboarding', description: 'Start the MCP Instruct onboarding process - sets up personal profile and AI agent', inputSchema: { type: 'object', properties: { action: { type: 'string', enum: ['start', 'check_status', 'quick_setup'], default: 'start', description: 'Onboarding action to perform' }, data: { type: 'object', description: 'Optional data for quick setup', properties: { name: { type: 'string' }, role: { type: 'string' }, preferredAgent: { type: 'string' } } } } } }