Autotask MCP Server

Instructions

Implementation Reference

• src/services/autotask.service.ts:332-351 (handler)

  Core implementation of ticket retrieval: calls Autotask API client.tickets.get(id), optionally optimizes output by truncating large fields.

  async getTicket(id: number, fullDetails: boolean = false): Promise<AutotaskTicket | null> {
    const client = await this.ensureClient();
    
    try {
      this.logger.debug(`Getting ticket with ID: ${id}, fullDetails: ${fullDetails}`);
      
      const result = await client.tickets.get(id);
      const ticket = result.data as AutotaskTicket;
      
      if (!ticket) {
        return null;
      }
      
      // Apply optimization unless full details requested
      return fullDetails ? ticket : this.optimizeTicketData(ticket);
    } catch (error) {
      this.logger.error(`Failed to get ticket ${id}:`, error);
      throw error;
    }
  }

• src/handlers/tool.handler.ts:1112-1115 (handler)

  Handler dispatch in AutotaskToolHandler.callTool(): maps tool arguments to service call.

  case 'get_ticket_details':
    result = await this.autotaskService.getTicket(args.ticketID, args.fullDetails);
    message = `Ticket details retrieved successfully`;
    break;

• src/handlers/tool.handler.ts:268-285 (schema)

  Tool schema definition: input schema with ticketID (required number) and optional fullDetails boolean.

    name: 'get_ticket_details',
    description: 'Get detailed information for a specific ticket by ID. Use this for full ticket data when needed.',
    inputSchema: {
      type: 'object',
      properties: {
        ticketID: {
          type: 'number',
          description: 'Ticket ID to retrieve'
        },
        fullDetails: {
          type: 'boolean',
          description: 'Whether to return full ticket details (default: false for optimized data)',
          default: false
        }
      },
      required: ['ticketID']
    }
  },

• src/mcp/server.ts:98-110 (registration)

  MCP server registration: setRequestHandler for ListToolsRequestSchema delegates to toolHandler.listTools() which includes get_ticket_details.

  this.server.setRequestHandler(ListToolsRequestSchema, async () => {
    try {
      this.logger.debug('Handling list tools request');
      const tools = await this.toolHandler.listTools();
      return { tools };
    } catch (error) {
      this.logger.error('Failed to list tools:', error);
      throw new McpError(
        ErrorCode.InternalError,
        `Failed to list tools: ${error instanceof Error ? error.message : 'Unknown error'}`
      );
    }
  });

• src/services/autotask.service.ts:534-560 (helper)

  Data optimization helper: truncates large text fields (description, resolution) and removes unnecessary data when fullDetails=false.

  private optimizeTicketData(ticket: AutotaskTicket): AutotaskTicket {
    const maxDescriptionLength = 500;
    const maxNotesLength = 300;
  
    return {
      ...ticket,
      // Truncate description if too long
      description: ticket.description && ticket.description.length > maxDescriptionLength
        ? ticket.description.substring(0, maxDescriptionLength) + '... [truncated]'
        : ticket.description,
      
      // Remove or truncate potentially large fields
      resolution: ticket.resolution && ticket.resolution.length > maxNotesLength
        ? ticket.resolution.substring(0, maxNotesLength) + '... [truncated]'
        : ticket.resolution,
        
      // Remove arrays that might contain large amounts of data
      userDefinedFields: [],
      
      // Keep only essential custom fields, truncate if present
      ...(ticket.purchaseOrderNumber && { 
        purchaseOrderNumber: ticket.purchaseOrderNumber.length > 50 
          ? ticket.purchaseOrderNumber.substring(0, 50) + '...' 
          : ticket.purchaseOrderNumber 
      })
    };
  }