create_program

Instructions

Implementation Reference

• src/handlers/tools.handler.ts:1170-1191 (handler)

  Handler function for the 'create_program' tool. Extracts arguments, formats dates, calls apiService.createProgram, and returns formatted response.

  case 'create_program': {
    const {
      name,
      startDate,
      endDate,
      agencyId
    } = args
  
    const program = await this.apiService.createProgram({
      name,
      startDate: formatDate(startDate),
      endDate: formatDate(endDate),
      agency: { id: agencyId }
    })
  
    return {
      content: [{
        type: 'text',
        text: `Programa "${name}" creado exitosamente.\n\nDetalles del programa:\n${JSON.stringify(program, null, 2)}`
      }]
    }
  }

• src/handlers/tools.handler.ts:104-128 (schema)

  Input schema definition and description for the 'create_program' tool in the listTools response.

    name: 'create_program',
    description: 'Crea un nuevo programa de viajes.  Antes de crear un nuevo programa se debe preguntar al si quiere que primero se busque el programa a ver si existe. Si no se especifica la fecha de inicio o fin del programa, no la asumas, pide al usuario que la especifique. Si no se especifica el ID de la agencia, pide al usuario que la especifique.',
    inputSchema: {
      type: 'object',
      properties: {
        name: {
          type: 'string',
          description: 'Nombre del programa'
        },
        startDate: {
          type: 'string',
          description: 'Fecha de inicio del programa (DD-MM-YYYY), salvo que el usuario lo indique las fechas siempre deben ser en el futuro'
        },
        endDate: {
          type: 'string',
          description: 'Fecha de fin del programa (DD-MM-YYYY), salvo que el usuario lo indique las fechas siempre deben ser en el futuro.  Y la fecha de fin debe ser mayor que la fecha de inicio'
        },
        agencyId: {
          type: 'string',
          description: 'ID de la agencia a asociar con este programa'
        }
      },
      required: ['name', 'startDate', 'endDate', 'agencyId']
    }
  },

• src/services/api.service.ts:106-119 (helper)

  Helper method in ApiService that performs the HTTP POST request to the backend API endpoint for creating a program.

  async createProgram (data: {
    name: string
    startDate: string
    endDate: string
    agency: { id: string }
  }) {
    const headers = await this.getHeaders()
    const response = await fetch(`${API_CONFIG.baseUrl}/integrations/mcp/programs/create`, {
      method: 'POST',
      headers: { ...headers, 'Content-Type': 'application/json' },
      body: JSON.stringify(data)
    })
    return await this.handleResponse<any>(response)
  }

• src/index.ts:42-47 (registration)

  Registers the callTool handler on the MCP server, which dispatches to the specific tool handler based on name, including 'create_program'.

  // Configure handlers for tools
  this.server.setRequestHandler(
    CallToolRequestSchema,
    async (request) => await this.toolsHandler.callTool(request.params.name, request.params.arguments, this.server)
  )

• src/utils/date.utils.ts:4-45 (helper)

  Utility function formatDate used in the handler to convert input dates to DD-MM-YYYY format before sending to API.

  export function formatDate (dateStr: unknown): string {
    // Type validation
    if (typeof dateStr !== 'string') {
      throw new McpError(
        ErrorCode.InvalidParams,
        'Date must be a string in YYYY-MM-DD format'
      )
    }
  
    // Try to parse the date with different formats
    const formats = [
      'YYYY-MM-DD',
      'MM/DD/YYYY',
      'DD MMMM YYYY',
      'YYYY-MM-DDTHH:mm:ss.SSSZ',
      'DD-MM-YYYY'
    ]
  
    const parsedDate = moment(dateStr, formats, true)
  
    // Check if the date is valid
    if (!parsedDate.isValid()) {
      throw new McpError(
        ErrorCode.InvalidParams,
        `Invalid date format: ${dateStr}`
      )
    }
  
    // Additional validation for impossible dates
    const month = parsedDate.month() + 1 // moment uses 0-11 for months
    const day = parsedDate.date()
  
    if (month > 12 || month < 1 || day > 31 || day < 1) {
      throw new McpError(
        ErrorCode.InvalidParams,
        `Invalid date format: ${dateStr}`
      )
    }
  
    // Return in the desired format
    return parsedDate.format('DD-MM-YYYY')
  }