Autotask MCP Server

Instructions

Implementation Reference

• src/handlers/tool.handler.ts:797-810 (registration)

  Registration of the 'get_quote' tool including name, description, and input schema definition in the listTools() method.

  {
    name: 'get_quote',
    description: 'Get a specific quote by ID',
    inputSchema: {
      type: 'object',
      properties: {
        quoteId: {
          type: 'number',
          description: 'The quote ID to retrieve'
        }
      },
      required: ['quoteId']
    }
  },

• src/handlers/tool.handler.ts:1271-1274 (handler)

  Handler dispatch in callTool() method that extracts args.quoteId and calls autotaskService.getQuote()

  case 'get_quote':
    result = await this.autotaskService.getQuote(args.quoteId);
    message = `Quote retrieved successfully`;
    break;

• src/services/autotask.service.ts:1510-1521 (handler)

  Core implementation of getQuote in AutotaskService that uses the autotask-node client to fetch the quote by ID from the Autotask API.

  async getQuote(id: number): Promise<AutotaskQuote | null> {
    const client = await this.ensureClient();
    
    try {
      this.logger.debug(`Getting quote with ID: ${id}`);
      const result = await client.quotes.get(id);
      return result.data as AutotaskQuote || null;
    } catch (error) {
      this.logger.error(`Failed to get quote ${id}:`, error);
      throw error;
    }
  }

• src/handlers/tool.handler.ts:800-810 (schema)

  Input schema validation definition for the 'get_quote' tool requiring a numeric quoteId.

    inputSchema: {
      type: 'object',
      properties: {
        quoteId: {
          type: 'number',
          description: 'The quote ID to retrieve'
        }
      },
      required: ['quoteId']
    }
  },