Autotask MCP Server

Instructions

Implementation Reference

• src/handlers/tool.handler.ts:484-501 (schema)

  Defines the input schema, name, and description for the get_ticket_note tool used in MCP tool listing/registration
  { name: 'get_ticket_note', description: 'Get a specific ticket note by ticket ID and note ID', inputSchema: { type: 'object', properties: { ticketId: { type: 'number', description: 'The ticket ID' }, noteId: { type: 'number', description: 'The note ID to retrieve' } }, required: ['ticketId', 'noteId'] } },
• src/handlers/tool.handler.ts:1174-1176 (handler)

  Handler dispatch in callTool method that invokes the service method with parsed arguments
  case 'get_ticket_note': result = await this.autotaskService.getTicketNote(args.ticketId, args.noteId); message = `Ticket note retrieved successfully`;
• src/services/autotask.service.ts:1197-1215 (handler)

  Core implementation: Queries the Autotask notes.list API endpoint filtered by ticketId and noteId to retrieve the specific ticket note
  async getTicketNote(ticketId: number, noteId: number): Promise<AutotaskTicketNote | null> { const client = await this.ensureClient(); try { this.logger.debug(`Getting ticket note - TicketID: ${ticketId}, NoteID: ${noteId}`); // Use generic notes endpoint with filtering const result = await client.notes.list({ filter: [ { field: 'ticketId', op: 'eq', value: ticketId }, { field: 'id', op: 'eq', value: noteId } ] }); const notes = (result.data as any[]) || []; return notes.length > 0 ? notes[0] as AutotaskTicketNote : null; } catch (error) { this.logger.error(`Failed to get ticket note ${noteId} for ticket ${ticketId}:`, error); throw error; } }